repo-agentdev-integrity

Validates REQ, ADR, skill, and command artifact consistency in the agent-dev-flow repository.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/yogata/agent-dev-flow --skill repo-agentdev-integrity-yogata
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: repo-agentdev-integrity
Source: https://github.com/yogata/agent-dev-flow/tree/main/.opencode/skills/repo-agentdev-integrity
Command: npx skills add https://github.com/yogata/agent-dev-flow --skill repo-agentdev-integrity-yogata

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Maintaining a self-hosted agent development workflow repository means keeping requirements files, ADRs, skill definitions, command files, and workflow templates mutually consistent; this Skill automates those mechanical integrity checks so drift, stale references, and legacy namespace remnants are detected reproducibly instead of by manual review. ## Core Features & Use Cases - Cross-artifact integrity validation: Runs validator scripts that check REQ frontmatter against filenames, ADR-to-REQ bidirectional references, command-map versus actual files, and detection of obsolete vocabulary and legacy paths. - Template and skill structure linting: Verifies workflow template structure and lints SKILL.md files for frontmatter, USE FOR boundaries, and description length rules. - Targeted change-scoped checks: Provides a targeted docs guard that inspects only changed files per workflow (req-save, design-save, case-run, case-close, docs-check) and emits JSON or Markdown reports. - Use Case: Before merging a pull request that renames a requirement file, run the integrity validators to confirm the README index, cross-references, and AUTOGEN blocks were regenerated, and receive a dated Markdown report under .agentdev/integrity/reports/. ## Quick Start Ask the agent to run the repo-agentdev-integrity validators against the repository and report any REQ, ADR, or skill consistency findings.

Frequently Asked Questions about repo-agentdev-integrity

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

FAQPage Schema
How do I run integrity checks on agent-dev-flow repository artifacts?▼

Run the validator scripts with Bun, for example bun run check_integrity.ts, from the skill's scripts directory. Use --json for machine-readable output, --dry-run to list targets, and --root to point at a worktree or CI checkout.

What does the targeted docs guard check for changed files?▼

The check_changed_docs.ts script validates only files changed in workflows like req-save, design-save, case-run, case-close, and docs-check. It accepts --files for explicit paths or --base-ref for git diff detection and reports failures, warnings, and README update requirements.

Can this skill be used in consumer projects outside agent-dev-flow?▼

No, it is a repo-local skill scoped to the agent-dev-flow self-hosting repository per ADR-0020. Consumer projects should not use it, and it is excluded from the distributed artifact set.

Does the integrity checker automatically fix detected problems?▼

No, the validators are read-only and never modify the artifacts they inspect. Permitted outputs are limited to Markdown or JSON reports, and regeneration of AUTOGEN blocks is done separately via generate_indexes.ts.

Why does the freshness check report stale AUTOGEN blocks?▼

Stale blocks occur when source files are renamed, added, removed, or change status without regenerating the index files. The check_autogen_freshness.ts script classifies the drift as rename, status_change, or content_change and instructs you to rerun the generator.