doc-align

Community

Grill plans against project docs for ADRs.

Authorleocosta
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Stress-tests a plan against the project's CONTEXT.md glossary and docs/adr/ decisions by grilling the user one question at a time, surfacing contradictions between user claims and the actual code, and updating CONTEXT.md/ADRs lazily as terms resolve.

Core Features & Use Cases

  • Map the domain by reading CONTEXT.md (or CONTEXT-MAP.md) and bootstrap a glossary stub if missing.
  • Walk the decision tree one question at a time, targeting terminology, code-claims, or documented decisions.
  • Surface contradictions immediately and pause progression to resolve them.
  • Update CONTEXT.md lazily with glossary terms as they resolve.
  • Propose an ADR when the triple gate passes, or document decisions in commits when it does not.

Quick Start

Map CONTEXT.md to bootstrap the glossary, then begin grilling one question at a time to surface contradictions and resolve terms.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: doc-align
Download link: https://github.com/leocosta/octopus/archive/main.zip#doc-align

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 510,000+ vetted skills library on demand.