Skip to content

docs(agents): split AGENTS.md and add post-merge lint workflow (#191)#533

Open
krokoko wants to merge 2 commits into
mainfrom
docs/191-agents-md-split
Open

docs(agents): split AGENTS.md and add post-merge lint workflow (#191)#533
krokoko wants to merge 2 commits into
mainfrom
docs/191-agents-md-split

Conversation

@krokoko

@krokoko krokoko commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Restructure agent context documentation for progressive disclosure: a lean root AGENTS.md router plus package-level guides for cdk/, cli/, agent/, and docs/. Closes the workflow gap from #191 by documenting post-merge eslint steps after merging main into a feature branch.

Area

  • cdk — infrastructure, handlers, constructs
  • agent — Python runtime / Docker image
  • clibgagent client
  • docs — guides or design sources (docs/guides/, docs/design/)
  • tooling — root mise.toml, scripts, CI workflows

Tip: AGENTS.md lists where to edit and which tests to extend.

Related

Changes

  • Root AGENTS.md: Commands-first layout, explicit git workflow (including post-merge mise //cdk:eslint + mise //cli:eslint), tri-tier boundaries, routing table with package guide links
  • New package guides: cdk/AGENTS.md, cli/AGENTS.md, agent/AGENTS.md, docs/AGENTS.md — each with commands, testing, READ/WRITE paths, code examples, boundaries, and package-specific pitfalls
  • Cross-links: CONTRIBUTING.md, DEVELOPER_GUIDE.md, and synced Starlight mirrors updated to point at package-level guides
  • CODEOWNERS: **/AGENTS.md added for package guide ownership

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of the project license.

Made with Cursor

Restructure agent context into a root router plus package guides (cdk, cli,
agent, docs) with commands-first layout, testing sections, and tri-tier
boundaries. Document the post-merge eslint workflow from #191 and cross-link
from CONTRIBUTING and the developer guide.

Co-authored-by: Cursor <cursoragent@cursor.com>
@krokoko krokoko requested review from a team as code owners July 6, 2026 17:40
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.

docs(AGENTS.md): add post-merge lint workflow to Common mistakes

2 participants