align-docs

Synchronize agent context across CLAUDE.md, AGENTS.md, and .agents/rules.

10|1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/reidemeister94/development-skills --skill align-docs-reidemeister94
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: align-docs
Source: https://github.com/reidemeister94/development-skills/tree/main/skills/align-docs
Command: npx skills add https://github.com/reidemeister94/development-skills --skill align-docs-reidemeister94

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Align Docs ensures a single canonical agent context across CLAUDE.md, AGENTS.md, and .agents/rules, eliminating drift between code and the people who work with it, by consolidating session discoveries and canonical references into the repository.

Core Features & Use Cases

  • Maintains a canonical context for Claude Code and Codex CLI by syncing key docs (CLAUDE.md, AGENTS.md, and .agents/rules) with the actual project structure.
  • Provides Step-by-step workflow for inventory, structure, capture, and memory management to keep agent context up-to-date across tasks and sessions.
  • Supports consolidation of discoveries into durable records (chronicles/plans) and validates structure with gate-like checks during verify.

Quick Start

Use Align Docs to synchronize the agent-context files across the repository and generate a unified, codified understanding of the project context.

Frequently Asked Questions about align-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep agent context files synchronized with my codebase?

To keep agent context files synchronized, Align Docs consolidates CLAUDE.md, AGENTS.md, and .agents/rules into a single canonical source of truth. It applies structured directories and lifecycle steps to eliminate drift between code and documentation during development.

What is the best way to maintain canonical rules across Claude Code and Codex CLI?

The best way to maintain canonical rules across Claude Code and Codex CLI is by using frontmatter-driven discovery to sync context files. Align Docs validates this structure with gate-like checks during verify to ensure project context remains unified.

How does frontmatter-driven discovery work for agent context management?

Frontmatter-driven discovery works by indexing project context across CLAUDE.md, AGENTS.md, and .agents/rules. This mechanism enables structured directories to capture session discoveries and maintain a single source of truth for agent context.

Can I consolidate session discoveries into durable records during code reviews?

Yes, you can consolidate session discoveries into durable records during code reviews. Align Docs captures these findings into chronicles and plans, ensuring that synchronized agent context is preserved across tasks and sessions.

What are the limitations of manual docs-architecture synchronization without lifecycle steps?

Without lifecycle steps like inventory, structure, capture, memory, and verification, manual docs-architecture synchronization suffers from context drift. Align Docs solves this by applying frontmatter-driven discovery and gate-like checks to maintain canonical references.

Do I need specific directory structures to align docs with codebase changes?

Yes, you need structured directories to align docs with codebase changes. Align Docs implements these structures alongside frontmatter-driven discovery to ensure that CLAUDE.md, AGENTS.md, and .agents/rules remain a single source of truth.