Grill With Docs

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

zenobi-us aad29f8 2 files · 1.2 KB Updated

File contents

Language

All agent-authored prose MUST follow ASD-STE100 Simplified Technical English. Apply it to questions, explanations, recommendations, issue text, reports, handoffs, and procedures.

  • Use short, complete sentences and active voice.
  • Use one term for one meaning.
  • Put conditions before commands.
  • Use imperative sentences for procedures.
  • Keep code, identifiers, commands, quoted text, product names, and exact domain terms unchanged.
  • Use the simple-english skill for the full rule set.

Local repository rules

Before reading or writing workflow or domain artifacts:

  1. Follow ALIGNMENT-ROOT.md.
  2. Resolve alignment paths against ALIGNMENT_ROOT.
  3. Keep source code and ordinary project files relative to repository-root.
  4. Do not silently mix alignment roots.
  5. All agent-authored prose MUST follow ASD-STE100 Simplified Technical English.

Call the Skill tool twice, for "grilling" and "domain-modeling".

zenobi-us/dotfiles/tree/main/files/devtools/agent/bundles/matt-pocock/skills/grill-with-docs commit aad29f84d3

Frequently asked questions

npx skillmds@latest add zenobi-us/grill-with-docs