Skip to content

docs: consolidate agent guidance - #87

Merged
codeasier merged 1 commit into
mainfrom
docs/consolidate-agent-guidance
Aug 7, 2026
Merged

codeasier merged 1 commit into
mainfrom
docs/consolidate-agent-guidance

Conversation

@codeasier

Copy link
Copy Markdown
Owner

📝 Description

  • Replace the hidden, duplicated .agents/quickstart/ documents with one source-backed root AGENTS.md.
  • Add a one-line CLAUDE.md import so Claude Code reuses the same guidance.
  • Correct stale CLI, query, model, snapshot, MCP, and test navigation while documenting cross-surface invariants.
  • Reorganize .gitignore for generated Python/tooling output and ignore local .agents/* content after the migration.

🔗 Related Issue

Related to #86, which tracks the follow-up audit of user-facing documentation and is not closed by this PR.

🧪 Testing

  • Tests added/updated (documentation-only change)
  • Manual testing completed
  • python3 ~/.agents/skills/agents-docs/scripts/validate_agents.py . --strict
  • git diff --check origin/main...HEAD

✅ Checklist

  • Code follows project guidelines
  • Documentation updated
  • No new warnings introduced
  • Changes tested locally

Snapshot Runtime Provenance

  • Snapshot provenance evaluation completed when snapshot runtime files change
    Snapshot provenance decision: no-update
    Snapshot provenance no-update reason: Agent documentation and ignore rules only; snapshot runtime files are unchanged.

📸 Screenshots (if applicable)

Not applicable.

📋 Additional Notes

Product tests were not run because no runtime code changed. Unrelated untracked benchmark, example, and generated architecture files remain outside the commit.

@codeasier
codeasier merged commit 4825d94 into main Aug 7, 2026
6 checks passed
@codeasier
codeasier deleted the docs/consolidate-agent-guidance branch August 7, 2026 17:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant