In the studioZen — a little more clarity for ambitious work
sico studio®
Open workspace
← Skills library

zen-grill / Reference

View source

Decision and terminology ledger

Offer a short choice and an editable free-text alternative for a consequential question. State a recommendation and its reason without pretending it is an owner's decision. The fields below are a summary pattern; a conversational host need not render a form, and an absent dashboard form must not be claimed as implemented.

QuestionDecision/statusEvidence or owner answerConsequenceRevisit trigger
Who owns writes?Settled: companionOwner answer and writer traceOffline browser changes waitAdding a second writer
What counts as applied?Settled: local acknowledgementPersistence/replay evidenceQueue receipt is insufficientTransport contract changes
Which preview feels right?Open: ownerThree runnable variantsSpecification waits on selectionOwner selects variant

For a consequential accepted choice create DOC with data.kind=adr and body: context; options considered; chosen behavior; rationale; consequences; evidence; owner/date; supersedes; revisit condition.

For terminology create/update a glossary DOC: term; precise meaning; excluded meanings; implementation/record links. Preserve unrelated terms on update.

Example: define “Review” as completed agent work awaiting inspection, “Done” as owner-confirmed completion, and “deployed” as an independently evidenced delivery state. These are different concepts even when one task has all three events.