doc-test-alignment
OfficialKeep docs and tests in lockstep.
Software Engineering#documentation#contributor workflow#repo verification#test alignment#CLI examples#skill contracts
Authoragentculture
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Prevents committed documentation from drifting away from what the repository’s code and tests actually do, reducing broken workflows and misleading contributor guidance.
Core Features & Use Cases
- Docs-to-code verification contract: Defines the alignment checks for README.md command examples, CLAUDE.md command lines, and per-skill SKILL.md descriptions versus their implementation scripts.
- Targeted drift detection: Flags discrepancies where prose claims behavior that the actual scripts and tests no longer provide, including stale or misleading test names.
- Stubbed gating until implemented: Provides a discoverable convention entry so contributors and automation can find and prioritize the real workflow as it’s built.
Quick Start
Run the skill entry point by executing scripts/check.sh and treat a green exit code as a bug until the real implementation lands.
Dependency Matrix
Required Modules
None requiredComponents
scripts
💻 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-test-alignment Download link: https://github.com/agentculture/culture/archive/main.zip#doc-test-alignment Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.