| name | context:atomic-doc |
| description | Create/update atomic documentation (blocks, foundations, stacks). Use when user asks to "create atomic doc", "add a block", "add a foundation", "setup a stack", or needs to document reusable knowledge. Creates files in context/ following SWEBOK-aligned structure. |
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
