# Soju06 Codex Lb Openspec Context Docs

> OpenSpec Context Docs

- Skill: `tomevault-io/soju06-codex-lb-openspec-context-docs` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/soju06-codex-lb-openspec-context-docs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/soju06-codex-lb-openspec-context-docs/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/soju06-codex-lb-openspec-context-docs

---


# OpenSpec Context Docs

## When to use

- Writing or updating OpenSpec documentation (specs, onboarding, guide, change artifacts).
- A spec is complete but readers lack background, rationale, examples, or operational notes.
- You need to preserve rich context without weakening SSOT.

## Core rule: two-layer docs

1) `spec.md` = normative, testable requirements (SHALL/MUST + scenarios).
2) Context docs = narrative and operational detail that helps humans understand and apply the spec.

## Locations

- Main specs:
  - `openspec/specs/<capability>/spec.md` (requirements)
  - `openspec/specs/<capability>/context.md` (preferred)
- Optional split (if context grows):
  - `overview.md`, `rationale.md`, `examples.md`, `ops.md` inside the same capability folder.
- Change-level notes (working context):
  - `openspec/changes/<change>/context.md` or `notes.md`

## Detail prompts (add depth without forcing a template)

Include at least 4 of these in context docs:
- Purpose / scope / non-goals
- Decision rationale + alternatives considered
- Constraints (security, performance, policy)
- Failure modes / edge cases
- Example request/response, data shape, or user flow
- Operational notes (rollout, monitoring, runbooks)
- Links to related specs/contracts

## Sync rule

- After implementation/verification, promote stable context from change notes into the main context docs.
- Do not duplicate normative requirements in context docs; link back to `spec.md`.
- Never create or update a `docs/` directory; keep everything under `openspec/`.

## Prompt snippet

"Keep `spec.md` strictly for requirements. Add/update `context.md` with purpose, decisions, constraints, failure modes, and at least one concrete example."

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/soju06) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->