Files

T

YeonGyu-Kim 330e437f08 docs(agents): regenerate hierarchical AGENTS.md for 2026-05-20

Sync the AGENTS.md hierarchy to current code state:

Drift fixes in 11 existing files
- Root: 2026-05-20 commit 39aadbf9f, ~2167 TS files, 120 barrel index.ts,
  57 src/hooks dirs, 297 (179 non-test) src/shared files, 11 OpenCode hook
  handlers in plugin-interface.ts, packages list adds ast-grep-mcp + rules-core,
  first-prompt-watchdog 206 LOC, parent-wake-notifier 587 LOC
- src/AGENTS.md: file counts, plugin-interface handler count
- src/shared/AGENTS.md: title + counts 278/170 -> 297/179
- src/hooks/AGENTS.md: 57 dirs, note unwired WIP (task-reminder,
  hashline-edit-diff-enhancer)
- src/features/AGENTS.md: module map with NON-TEST counts + sub-AGENTS.md
  column, 7 modules without sub-doc
- src/features/background-agent/AGENTS.md: add 12 newer files (parent-wake-
  notifier 587 LOC, loop-detector, error-classifier, fallback-retry-handler,
  process-cleanup, subagent-spawn-limits, session-status-classifier,
  compaction-aware-message-resolver, etc.)
- src/plugin/AGENTS.md: 11 handlers, add system-transform.ts + command-
  execute-before.ts + build-team-idle-wake-hint-client.ts
- src/config/AGENTS.md: note schema/internal/permission.ts
- src/cli/AGENTS.md: 8 commands including 'version'
- src/plugin-handlers/AGENTS.md, packages/web/AGENTS.md: date bump

New AGENTS.md in 4 directories
- packages/AGENTS.md: index of 15 packages (11 platform binaries + 2 MCP
  packages + rules-core + web), role map, conventions
- docs/AGENTS.md: WHERE TO LOOK table for 19 docs across 6 subdirs
- .opencode/AGENTS.md: 5 skills + 4 slash commands + relationship to .agents/
- .agents/AGENTS.md: superset migration target (9 skills + 4 commands)

2026-05-20 17:18:44 +09:00

3.4 KiB

Raw Blame History

.agents/ — Project-Scope Skills & Commands (Migration Target)

Generated: 2026-05-20

OVERVIEW

Project-scope skills + slash commands under the new .agents/ directory name. During the oh-my-opencode → oh-my-openagent rename transition, this directory is the target of the migration from .opencode/. It is a strict SUPERSET of .opencode/ (5 → 9 skills; same 4 commands).

Loaded alongside .opencode/ by src/features/opencode-skill-loader/. When both directories declare the same skill or command name, the higher-priority scope wins per the loader's deduplication rules.

SKILLS (9, superset of `.opencode/`)

Skill	Also in `.opencode/`?	Purpose
`work-with-pr/`	yes	Full PR lifecycle
`work-with-pr-workspace/`	yes	Iteration workspace + benchmark inputs
`github-triage/`	yes	Read-only issue/PR triage with evidence reports
`hyperplan/`	yes	Adversarial multi-agent planning
`pre-publish-review/`	yes	16-agent pre-publish release gate
`get-unpublished-changes/`	NEW	Skill form of the `/get-unpublished-changes` command
`omomomo/`	NEW	Skill form of the `/omomomo` easter egg
`publish/`	NEW	Skill form of the `/publish` command
`remove-deadcode/`	NEW	Skill form of the `/remove-deadcode` command

The 4 "NEW" skills here are skill-format equivalents of the 4 slash commands that exist in BOTH .opencode/command/ and .agents/command/. They allow the same instructions to be triggered either by an explicit /command invocation OR by skill auto-loading on matching prompts.

COMMANDS (4 slash commands)

Identical set to .opencode/command/:

/get-unpublished-changes
/omomomo
/publish
/remove-deadcode

MIGRATION STATUS

Concern	Plan
Why TWO directories?	`.opencode/` is the legacy layout. `.agents/` is the future-proof name after the harness rename.
When does `.opencode/` go away?	After the multi-harness refactor lands and existing users have re-installed. Tracked in ROADMAP.
What if both exist with conflicting skills?	The skill-loader dedupes by name. Higher-priority scope wins. The 5 shared skills (`work-with-pr`, `hyperplan`, etc.) are byte-identical between the two dirs today; if they diverge, fix here first.
Where do NEW skills go?	`.agents/` only. Do NOT add new entries to `.opencode/`.

CONVENTIONS

All NEW skills go in .agents/. .opencode/ is frozen aside from drift-sync of the 5 shared skills.
Drift between shared skills is a bug. When you update a shared skill, update both copies in the SAME commit until .opencode/ is removed.
Slash commands stay duplicated. Both directories must contain the same command/*.md set for the transition window.

ANTI-PATTERNS

Never add a skill to .opencode/ that does not also exist in .agents/.
Never let the 5 shared skills drift. CI should eventually enforce byte equality; for now, manual diligence.
Never delete .opencode/ until the multi-harness refactor lands.

3.4 KiB Raw Blame History