Menu
Finalize architecture and lock the spec for development.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | planning-protocol |
| description | Finalize architecture and lock the spec for development. |
Work with the user to create a new file kb/specs/<YYYYMMDD>-<slug>.md.
Content Requirements:
Reset kb/sessions/planning.state.json to idle.
Acquire Atomic Lock. Append to kb/ledger/ledger.jsonl:
{
"event": "PLAN-LOCKED",
"timestamp": "<ISO-8601>",
"spec_file": "kb/specs/<filename>.md",
"native_session_id": "<brain-uuid>",
"handoff_to": "dev-sqe"
}
Release Lock.
DEV-SQE session handoff protocol. Captures files changed, tests added, coverage data, and report paths. Updates ledger, summary, and state files. Detects design gaps and creates handoff documents when blocked.
Planning session handoff protocol. Captures task breakdowns, architecture decisions, acceptance criteria, and dependency maps. Updates ledger, summary, and state files. Produces handoff documents to DEV-SQE when tasks are ready for implementation.
Pre-PR session handoff protocol. Validates code quality, runs checks, verifies documentation, and prepares PR artifacts. Updates ledger, summary, and state files.
DEV-SQE session handoff protocol. Captures files changed (committed and uncommitted), tests added, coverage data, and report paths. Updates ledger, summary, and state files. Detects design gaps.