Skip to content

docs: generate AGENTS.md from agent instruction units - #23

Merged
showxu merged 8 commits into
masterfrom
docs/agent-instructions
Oct 26, 2026
Merged

showxu merged 8 commits into
masterfrom
docs/agent-instructions

Conversation

@showxu

@showxu showxu commented Oct 26, 2026

Copy link
Copy Markdown
Contributor

Summary

AGENTS.md is now generated by agents from instruction units that this repository owns.

  • Units, in generated order:
    • guide: Route changes to computer-mcp organization data, conventions, design assets and shared instruction units.
  • Shared units that member repositories install by name:
    • shared/plugin-rules: Keep a Computer MCP plugin free of vendor software and host authority, and validate its package before handoff.
  • .agent/agents.json declares the selection and .agent/agents.resolved locks it. The ignore rules track these and .agent/instructions/; the rest of .agent/ stays local.
  • Sections no longer in AGENTS.md under the same heading: First-Principles Work, Canonical Artifacts, Authority, Boundary Guardrails, Operating Notes. Generic principles are no longer copied here; README and the docs own product and architecture facts.
  • Also updated: MAINTENANCE.md.
  • Shared workflows are pinned to computer-mcp/github-workflows@36a8e11, whose policy accepts the tracked instruction files.

Verification

  • agents instructions update reports no changes, and agents doctor reports no problems.
  • The organization's pinned source policy passes on this branch when run locally.
  • git diff --check is clean.

Merge order

  • After computer-mcp/github-workflows merges its policy change, the workflow pins move to the merged commit.

@showxu
showxu merged commit b7c9d5b into master Oct 26, 2026
3 checks passed
@showxu
showxu deleted the docs/agent-instructions branch October 26, 2026 18:20
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