shield_lock
JinDaGe
← Back to skills
extension
Category: Development & EngineeringNo API key required

context:atomic-doc

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.

personAuthor: jakexiaohubgithub
open_in_newRepositorydownloadDownload package

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:

  1. Parse $ARGUMENTS:

    • create <layer>/<domain>/<name> → new doc
    • update <path> → modify existing
    • No args → ask user what they want to create/update

  2. 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