Workflow layer · Claude Code · v0.6.6
Discipline
on top of AI.
Nogra is an optional workflow layer for Claude Code. For scoped or risky work, it helps you approve a short plan, run the approved work, and verify the result against that plan before calling it done.
Brief · brief-014
- scope
- a local task tracker
- evidence
- tests pass · work committed
- stop
- out-of-scope, abort
Dispatch · fresh executor
receipt returned · no parent context to defend
Verify · separate pass
The work leaves a record, not a memory.
Ordinary chat, direct code edits, debugging, and implementation stay direct unless you ask for Nogra. When you do, Nogra keeps role, scope, approval, evidence, and local state visible inside the installed Claude Code surface.
The contract
Five primitives.
One disciplined loop.
What operators kept rewriting into every prompt, turned into a workflow surface the model can be checked against.
- 01
Orchestration Plan.
Before complex work becomes a brief, the work gets shaped. Single run, sequential chunks, continuation, verify-only, or direct/native. The topology is part of the contract.
Nogra keeps role, lane, evidence, GO boundary, and next owner explicit before work starts. The plan is the line between scoped execution and one vague run.
Role distribution is responsibility clarity.
- 02
Brief.
A declarative contract written before anything runs. Scope, evidence shape, abort criteria. Stored as markdown in .nogra/briefs/. Reviewable before dispatch.
Replaces the pattern of stuffing rules into every prompt. The model can pad an output. It cannot quietly change a brief you approved.
Intent is what the brief said. Shape is what the prompt got.
- 03
Dispatch.
Runs an approved brief after GO in an executor role inside Claude Code. The executor gets the brief, scope, stop criteria, and evidence contract directly. Returns a receipt with a run-id.
No hidden parent context to complete against. No conversation history to defend. Just the approved scope and the work.
Fresh context. No collusion surface.
- 04
Verify.
A separate pass. The verifier sees the brief and the output — never the executor's reasoning. Returns explicit OK, Partial, or Blocked against the brief's evidence contract.
No hedging surface. No maybe-column. The model that did the work doesn't sign off on it.
The verifier judges output. Not reasoning.
- 05
Workspace state.
Everything Nogra writes lives in .nogra/ inside your project. Briefs, transport receipts, run logs, session checkpoints, decisions. Plain markdown and JSON. Readable, editable, committable.
State on disk outlives the conversation that wrote it. New sessions pick up from files. Model updates don't break setups.
Conversations end. Files stay.
Done is a claim.
Verification is the check.
Install the plugin, set up the workspace, then pull Nogra in when the work needs a plan, approval, evidence, and a local record.