sdd-quick
Deliver a small bounded change inside an initialized SDD Composy workspace through the quick path: at most five implementation files, a registered TASK, TDD, evidence, trace, and a verified verdict, e
SKILL.mdplugins/sdd-composy/skills/sdd-quick/SKILL.md
GitHubSDD Quick
Use this portable skill ($sdd-quick in Codex mentions) only for a precise bounded objective in
an initialized SDD Composy workspace. A quick task is a controlled entry path into the normal SDD
flow, not a shortcut around review, evidence, or verification.
Language: before writing human-facing prose, run scripts/sdd_language.py <repo-root> and use the persisted language; on not_initialized, return it with next_action: run_init. Localization rules: references/language.md.
Required protocol
- Inspect repository instructions and preserve unrelated changes.
- Reject or
ESCALATEbefore edits if more than five implementation files, architecture, migration, destructive work, scope change, or unknown verification is involved. When a machine-readable eligibility decision is needed, use the side-effect-free gatescripts/sdd_quick.py <contract.json>. - Read
templates/quick-contract.mdand render the OKFQUICK_CONTRACTfrom it (keep its keys and headings), assign aQ-*identifier (the Q-ID), and register a normalTASK-*record: rendertasks/prd-<slug>/task-<id>.mdfromtemplates/task.mdand runscripts/sdd_tasks.py import; quick work never bypasses task lifecycle gates and records its gate evidence withsdd_tasks.py evidence. - Write and run a failing test before implementation (TDD). If it cannot be run, escalate.
- Implement only within the closed allowed-file list and run the known verification.
- Collect acceptance evidence, review, and verification. Append semantic events with
scripts/sdd_trace.py record <repo-root> --event <event.json>only after their actions succeed; never writetrace.jsondirectly. - Create the OKF
QUICK_REPORTfromtemplates/quick-report.md, link all evidence from the bundle index, verify the trace and artifact integrity, and publish aCOMPLETEverified verdict only when every gate passes. Otherwise reportESCALATED,REJECTED, orCAVEATS.
Never record prompts, output dumps, environment variables, secrets, models, or private paths. Do
not silently expand scope. If quick work needs a task synchronization, the plan-bound
CONFIRM-SDD-SYNC-… token of sdd-sync still applies.
Read when
references/quick.md— the eligibility gate is unclear, or when writing the contract (step 3) and the report (step 7).
Safety: Do not commit, push, or publish. Do not read or expose .env, credentials, tokens, private keys, certificates, or fleet environment files. Full contract: references/safety.md.