Atomic Documentation
Create or update context documentation following the atomic documentation system.
Execution Instructions
When this skill is invoked:
MANDATORY FIRST STEP: Use the Read tool to read context/workflows/manage-atomic-doc.md (relative to project root). DO NOT proceed without reading this file first - it contains the complete workflow including Phase 0 (index check) that you MUST follow.
After reading the workflow file:
Parse
$ARGUMENTS:create <layer>/<domain>/<name>→ new docupdate <path>→ modify existing- No args → ask user what they want to create/update
Follow ALL phases in the workflow file, starting with Phase 0.
Quick Reference
| Layer | Purpose | Examples |
|---|---|---|
blocks |
Single units of knowledge (tool-centric) | bun.md, eslint.md, vitest.md |
foundations |
Capabilities (combines blocks) | exec-tsx.md, test-unit-vitest.md |
stacks |
Complete project setups | cli-bun.md, api-pnpm-fastify.md |
| Domain | SWEBOK Area | What It Covers |
|---|---|---|
construct |
Software Construction | Build, bundle, package |
test |
Software Testing | Unit, E2E, coverage |
quality |
Software Quality | Lint, format, style |
security |
Software Security | Auth, secrets, hardening |
scm |
Config Management | Version, release, publish |
ops |
SE Operations | CI/CD, deploy, infra |
observe |
Operations (sub-area) | Log, trace, metrics |
docs |
Architecture & Design | ADRs, diagrams, prompting |
Usage
/context:atomic-doc create blocks/test/playwright.md
/context:atomic-doc create foundations/construct/bundle-web-esbuild.md
/context:atomic-doc update context/blocks/construct/bun.md
References
- Full workflow: @context/workflows/manage-atomic-doc.md
- Philosophy & naming: @context/blocks/docs/atomic-documentation.md
- Maintenance patterns: @context/blocks/docs/maintenance.md
- Index of all docs: @context/README.md