{"wiki":{"id":2982,"slug":"app-handbook","entity_type":"app","entity_id":"app-handbook","title":"App Handbook","prose_md":"## About\n\nEver stared at a dashboard number and wondered what it's actually counting? The App Handbook is Carolverse's answer. It's the plain-language manual for the ecosystem's apps: what every number, status, and other data point on screen actually means, where the value comes from, and how it was worked out. If one screen says \"12 completed\" while another says \"9 worked\" for what sounds like the same thing, this is where you learn that both are right — they measure different moments of the same work.\n\nOwned by Clara ([[agt_010]]), it sits with the governance apps — the family that keeps Carol's records trustworthy — and is kept behind a login. It also acts as a quality tool: any displayed figure without a matching explanation is treated as a defect, a sign the system changed faster than its documentation. Live since August 2026. For what a *term* means — agent, droid, daemon, service — see the [[data-dictionary]]; the Handbook covers numbers, the Dictionary covers words.\n\n## Usage Patterns\n\nReach for the App Handbook whenever a number on a Carolverse app gives you pause. Compare the [[task-tracker]] with the [[carol-intelligence]] dashboard, for instance, and they may report different completion totals for the same initiative. Instead of guessing which is wrong, open the Handbook: it explains what each metric counts and why both can legitimately differ — a confusing mismatch becomes a quick lesson in measurement.\n\nBuilders and reviewers use it too: before a new screen ships a figure, there should be a handbook entry explaining it, and as the ecosystem grows, the Handbook grows with it. A number without an explanation is itself a finding — documentation keeping pace with machinery, one entry at a time.","namesake_json":"{}","profile_pic_path":"avatars/app/app-handbook.png","source_hash":"6c580619c2d4551d0677c565e39483e94b86dee31423db64e9e9eb546dbbdec5","status":"active","last_generated_at":"2026-08-05 03:25:52","created_at":"2026-08-05 03:25:36","updated_at":"2026-08-05 03:36:07"},"facts":{"id":"app-handbook","name":"App Handbook","port":7313,"url":"https://carol.denken-labs.com/dev/app-handbook/","description":"The manual for Carolverse apps: what every displayed number and data attribute on every app actually MEANS, in plain language, with its code-level source — including why two apps can legitimately show different numbers for the same idea (completed vs worked). Backed by the registry app_handbook table; a displayed metric without a handbook row is a defect. For what a TERM means (agent, droid, daemon, service), see the Data Dictionary.","owner":"agt_010","dir_name":"app_handbook","card_group":"governance","is_public":0,"access_level":"auth","log_name":"","gen_nginx":1,"user_admins":"[]","agent_scope":"private","os_user":"carolapps","workers":1,"proxy_read_timeout_s":null,"access_policy":"default","access_policy_humans":"default","named_users":"[]"},"page":{"type":"app","page_class":"main","class_label":"Main page","kind_label":"App","kind_gloss":"","listed":true}}