feat: centralize agent docs harness

[caorushizi]

No description provided.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
one-cli-docs	Ready	Preview, Comment	Jun 21, 2026 5:23pm

[Copilot]

Pull request overview

This PR centralizes the workspace “agent docs” into a single canonical router (AGENTS.md) plus a generated .one/agents/ tree, with CLAUDE.md becoming a pointer to avoid duplicated / drifting guide content.

Changes:

• Scaffold now writes AGENTS.md, a pointer CLAUDE.md, and .one/agents/conventions.md at one create time.
• ai.Refresh now generates .one/agents/projects/*.md and .one/agents/ops/*.md from one.manifest.json, and updates the AGENTS index + subproject table.
• Docs, references, error-code grouping text, and CLI snapshot fixtures are updated to reflect the new “agent docs harness”.

Reviewed changes

Copilot reviewed 25 out of 25 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
packages/templates/go-lib/README.md.hbs	Updates template README to point to centralized .one/agents/projects/... guide instead of per-project CLAUDE.md.
packages/skills/one-cli/SKILL.md	Updates skill guidance to treat .one/agents/** as generated agent docs and clarifies canonical entry points.
packages/skills/one-cli/references/bootstrap.md	Updates bootstrap reference to mention .one/agents/** in refreshed outputs.
packages/skills/one-cli/references/add-feature.md	Updates add-feature reference wording from “AI guides” to “agent docs” and includes .one/agents/**.
packages/cli/tools/gen-error-codes/main.go	Renames the error code group label/intro to “Agent docs / Skills” and includes .one/agents/**.
packages/cli/testdata/reference/add-go-api.json	Updates reference JSON fixture to include new generated agent docs files and new file count.
packages/cli/internal/template/render.go	Prevents template renderer from copying AGENTS.md / CLAUDE.md into subprojects.
packages/cli/internal/scaffold/scaffold.go	Scaffolds AGENTS.md, pointer CLAUDE.md, and .one/agents/conventions.md.
packages/cli/internal/scaffold/scaffold_test.go	Updates scaffold tests to reflect “agent docs” terminology.
packages/cli/internal/scaffold/content.go	Replaces inline CLAUDE skeleton with calls into centralized internal/ai content helpers.
packages/cli/internal/errors/codes.go	Renames “AI guides / skills” section label to “Agent docs / skills” and updates summary wording.
packages/cli/internal/cmd/addcmd/cmd.go	Updates TTY output label from “AI guides” to “Agent docs”.
packages/cli/internal/cli/snapshot_e2e_create_test.go	Updates create snapshot expectations to include AGENTS.md and .one/agents/conventions.md and asserts CLAUDE pointer content.
packages/cli/internal/cli/snapshot_e2e_add_test.go	Updates add snapshot expectations: no subproject CLAUDE.md, expects centralized .one/agents/... outputs, and asserts pointer + index contents.
packages/cli/internal/ai/subprojects.go	Moves subproject index maintenance to AGENTS.md and links to .one/agents/projects/... guides.
packages/cli/internal/ai/content.go	Adds centralized content generators for root AGENTS, CLAUDE pointer, conventions, and ops docs.
packages/cli/internal/ai/ai.go	Refactors refresh to generate the new harness layout and migrate legacy managed blocks.
packages/cli/internal/ai/ai_test.go	Updates tests to assert new generated file set and CLAUDE pointer behavior.
packages/cli/internal/ai/agentsdir.go	Implements .one/agents/ writing (projects + ops), index rendering, and CLAUDE pointer update logic.
apps/docs/content/docs/zh/error-codes.md	Updates docs section label/intro and AI_GUIDES_FAILED wording to “Agent docs”.
apps/docs/content/docs/zh/ai-native.md	Updates narrative to describe the new harness structure and centralized .one/agents/ docs.
apps/docs/content/docs/zh/add.md	Updates add docs example output and wording to include .one/agents/** and relative paths.
apps/docs/content/docs/en/error-codes.md	Updates docs section label/intro and AI_GUIDES_FAILED wording to “Agent docs”.
apps/docs/content/docs/en/ai-native.md	Updates narrative to describe the new harness structure and centralized .one/agents/ docs.
apps/docs/content/docs/en/add.md	Updates add docs example output and wording to include .one/agents/** and relative paths.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.