Sync Index

Keep project documentation (.agentss/project-index.md and sub-skills) in sync with codebase changes.

B4san 9c5061a 1.1 KB Updated 2 repo stars

File contents

Documentation Sync

Overview

Documentation drift is a major problem. Use this skill to ensure that the project index and agent guidance files are always up-to-date with the codebase.

Workflow

  1. Detect Changes:

    • Ideally run after major feature implementation or refactoring.
    • Compare current file structure with project-index.md.
  2. Run Indexer:

    • Execute the project-index skill again.
    • Verify that new modules/directories are captured.
    • Ensure deleted files are removed from documentation.
  3. Update Guidance:

    • Check agent-*.md files in domain directories.
    • Update any obsolete instructions.
    • Add new patterns discovered during implementation.
  4. Verify Links:

    • Ensure all links in README.md and AGENTS.md point to valid locations.

Output

  • Updated project-index.md.
  • Updated domain-specific agent guides.
  • Confirmation of documentation sync.

B4san/AC-framework/tree/main/framework/new_project/.roo/skills/sync-index commit 9c5061a1d1

Frequently asked questions

npx skillmds add b4san/sync-index