Military-spec skill
Military-spec skill
Writes technical specifications in military-English spec language for LLM agents — precise, testable statements with one-sentence acceptance criteria. Used whenever a spec, AC set, or DoD definition is authored for agent consumption.
Trigger
- "write the spec", "define the acceptance criteria", "military spec this", any task producing specs/ACs/DoD that agents will execute against.
Contract
- Location:
repayments/.agents/skills/military-spec/SKILL.md(also mirrored in the Devin plugin cache). - Version: see the skill's SKILL.md metadata.
- Install: copy the skill directory into the agent's skills dir, or rely on the plugin cache where present.
- Inputs: the feature intent, Linear issue or KB entries (
kb:citations), regulatory constraints where applicable. - Outputs: a spec document with numbered requirements and one-sentence, testable acceptance criteria per requirement.
How it works
- Restate intent as numbered requirements (shall-statements), each independently testable.
- Attach exactly one acceptance criterion sentence per requirement — observable, pass/fail, no judgement calls.
- Mark dependencies and constraints explicitly; cite
kb:<id>for any knowledge-base-sourced rule. - Keep language military-precise: no "should", no "etc", no ambiguous quantifiers — every statement admits one interpretation.
Rules
- One AC sentence per requirement; multi-clause ACs get split into separate requirements.
- Every requirement traceable: to a Linear AC, a KB entry, or a regulation criterion (
kb:citation). - Specs feed the delivery chain's design stage; ACs are what review is adversarially checked against.
Anti-patterns
- ACs that are opinions ("works well", "is user-friendly") instead of testable statements.
- Requirements without ACs or ACs without requirements.
- Specs that agents must interpret creatively — ambiguity is a defect, not flexibility.
- Duplicating KB rules inline instead of citing
kb:<id>(drift).
Sources
- repayments/.agents/skills/military-spec/SKILL.md
- factory/build-process.md (SPEC stage), knowledge-base/SPEC.md