ai-workflow-skill/AGENTS.md

AGENTS.md

Scope

This file applies to the entire repository.

Read First

Before starting substantial work, read the roadmap that matches the task:

• implementation work: docs/implementation-roadmap.md
• inbox Markdown test-plan work: docs/tests/inbox/ROADMAP.md

Roadmap Update Rule

Updating the relevant roadmap is part of the definition of done.

Do not finish a task and leave its roadmap stale.

Required behavior:

• if you complete or materially change implementation progress, update docs/implementation-roadmap.md in the same change
• if you add, remove, or materially revise inbox Markdown test cases or test-plan documents, update docs/tests/inbox/ROADMAP.md in the same change
• when a test-plan document is created, update document progress
• when a test case is written, update authored-case tracking and pending backlog
• when a planned item is no longer needed, mark it as removed or deferred instead of silently dropping it

Inbox Test-Plan Specific Rule

For docs/tests/inbox/:

• organize by folder plus README.md
• do not use numeric test IDs
• use stable case slugs and keep the roadmap synchronized with the actual files on disk