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-englishskill for the full rule set.
Local repository rules
Before reading or writing workflow or domain artifacts:
- Follow ALIGNMENT-ROOT.md.
- Resolve alignment paths against
ALIGNMENT_ROOT. - Keep source code and ordinary project files relative to
repository-root. - Do not silently mix alignment roots.
- All agent-authored prose MUST follow ASD-STE100 Simplified Technical English.
Spin up a background agent to do the research, so you keep working while it reads.
Its job:
- Investigate the question against primary sources (official docs, source code, specs, first-party APIs), not a secondary write-up of them. Follow every claim back to the source that owns it.
- Write the findings to a single Markdown file, citing each claim's source.
- Save it where the repo already keeps such notes; match the existing convention, and if there is none, put it somewhere sensible and say where.