Product details reviewed and diagrams updated · 2026-09-16. Release notes

The next move comes from current company state, dependencies and the work that is actually ready.

01

Read the files before proposing work

profile.json describes the company. state.json holds current progress. The build map, ledger, dials and other local context establish what has happened, what is allowed and what is ready. The session should not re-invent those facts from memory.

/casa-next is a harness skill, not a shell executable. In a harness without native skill registration, read and follow the corresponding SKILL.md from the Casa checkout.

This opening read is what makes a session a continuation of the business. A previous decision may rule out an otherwise attractive task. An unfinished dependency may make a play unavailable. A department dial may change how execution proceeds. Those facts should shape the next move before an operator spends time producing a deliverable that cannot be used.

Casa / session entryRead the company before choosing the work.
Profile, state, build map, department dials, ledger and decisions determine the next eligible deliverable.SESSION INPUT / READ BEFORE PROPOSINGContext the session readsprofile.jsonWho the company servesstate.jsonCurrent progressbuild-map.jsonDependencies and eligible workdials.jsonDepartment autonomyledger + decisionsHistory and commitmentsA GROUNDED NEXT MOVEWhat is ready?Which dependency is satisfied?Which constraint should move?What artifact will prove the work?/casa-nextA harness skill, not a shell executable.Persistent files supply the company facts; the session should not reconstruct them from memory.
Swipe to explore the full diagram
02

Produce and review a concrete artifact

The chosen operator works to a playbook’s deliverable and rubric. A Phase 0 product-flow play, for example, produces a Mermaid file in its own output directory. The review is about whether that artifact meets the contract, with evidence for its claims.

A file existing on disk is not sufficient reason to mark a play complete. Resolve review findings, keep the artifact path and relevant commitments in the recorded work, and obtain approval for actions that cross a gate.

Review the artifact in the context of the company, not just as a well-formed file. For a product flow, check whether its actors and transitions agree with the brief, whether failure paths are understandable and whether planned behavior is presented as planned. A syntactically valid diagram can still describe the wrong product.

When a review finds a gap, return to the deliverable with a specific correction. Keep unresolved findings open and distinguish a proposed action from an executed one. This creates a record that a founder or a later session can follow without guessing which parts of the work were actually accepted.

Casa / artifact reviewReview the contract, evidence and coherence.
An example product-flow artifact is checked against its deliverable, evidence and company context; failed reviews return to the artifact.REVIEW AN ARTIFACT / NOT JUST THE EXISTENCE OF A FILEEXAMPLE / PRODUCT-FLOW DELIVERABLEMermaid product flowUser inputAgent action + system transitionObservable result + failure pathREVIEW QUESTIONSContractDoes it satisfy the requested deliverable?EvidenceAre current capabilities distinguished?CoherenceDoes it agree with the brief and model?OutcomeRevise, approve or leave work open.A failed review returns to the artifact. Record completion only when the deliverable earns it.
Swipe to explore the full diagram
03

Record the result and understand the connection

The brain preserves state, events and decisions so the next session begins with the updated company. Ordinary local work does not need a public service. A bound integration has a separate continuing publication path, including a guarded SessionEnd hook.

The website’s operating examples use synthetic demo data. They illustrate a workflow, not a live customer transcript or measured business performance.

A useful handoff connects three things: the artifact path, the review outcome and the resulting company state. The next session can then see what changed and what remains ready to do. If an important business choice was made along the way, preserve its reasoning in the appropriate decision record rather than expecting an event entry to explain it fully.

Casa / session handoffLeave a result the next session can inspect.
The artifact, its review and the updated state together make a durable handoff.DURABLE HANDOFF / WHAT THE NEXT SESSION CAN FINDOUTPUT PATHThe artifactConcrete files on diskReviewable deliverableLinks to supporting workQUALITY RECORDThe reviewFindings and revisionsWhat passed its contractWhat remains unresolvedCURRENT PROGRESSThe stateCompleted eligible workDecisions that persistContext for the next moveThe next session reads the updated company.Ordinary local work can remain local. A bound public integration has its own update behavior.
Swipe to explore the full diagram
Company brain referenceBuild the company package
END NOTE