Skip to content

Add agent skills configuration#1048

Merged
donnchawp merged 4 commits into
trunkfrom
add-agent-skills-config
May 19, 2026
Merged

Add agent skills configuration#1048
donnchawp merged 4 commits into
trunkfrom
add-agent-skills-config

Conversation

@donnchawp
Copy link
Copy Markdown
Contributor

@donnchawp donnchawp commented May 19, 2026

Summary

  • Scaffolds AGENTS.md (with ## Agent skills block) and CLAUDE.md (which loads AGENTS.md via @AGENTS.md) at the repo root.
  • Adds docs/agents/issue-tracker.md, docs/agents/triage-labels.md, and docs/agents/domain.md so AI agent skills (triage, to-issues, diagnose, tdd, grill-with-docs, etc.) know where issues live, which triage labels to apply, and how to read domain docs.
  • Establishes a five-label triage state machine: needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix (the first four were created as repo labels alongside this PR; wontfix already existed).
  • Also pins pnpm to v10 in the E2E workflow (pnpm/action-setup@v4 was set to version: latest, which now pulls pnpm 11 and breaks the install with ERR_PNPM_IGNORED_BUILDS). Combined with Bump E2E workflow Node.js to 22 #1049's Node 22 bump, this restores a green E2E run. We can revisit moving to pnpm 11 separately when the project is ready to adopt its new build-approval workflow.

Test plan

  • Confirm AGENTS.md and CLAUDE.md render correctly on GitHub.
  • Verify the four new triage labels exist on the repo (needs-triage, needs-info, ready-for-agent, ready-for-human).
  • Run /triage locally and confirm it reads the label mapping from docs/agents/triage-labels.md without prompting for setup.
  • E2E Tests check on this PR turns green.

donnchawp added 2 commits May 19, 2026 17:41
Scaffold AGENTS.md, CLAUDE.md, and docs/agents/ so AI agent skills
(triage, to-issues, diagnose, tdd, etc.) know where issues live, which
triage labels to apply, and how to read domain docs in this repo.

- AGENTS.md: top-level agent instructions with the Agent skills block
- CLAUDE.md: re-exports AGENTS.md via @AGENTS.md syntax
- docs/agents/issue-tracker.md: GitHub conventions (gh CLI)
- docs/agents/triage-labels.md: canonical triage label mapping
- docs/agents/domain.md: single-context CONTEXT.md / docs/adr layout
pnpm 11 no longer reads the "pnpm" field from package.json and warns
"The 'pnpm' field in package.json is no longer read by pnpm." Because
unrs-resolver's build script was no longer approved, pnpm 11 treated the
ignored build as fatal (ERR_PNPM_IGNORED_BUILDS) and failed the install.

Move the setting to pnpm-workspace.yaml (pnpm 11's new home for it) and
drop the now-dead pnpm field from package.json.
@donnchawp donnchawp force-pushed the add-agent-skills-config branch from cbb0afc to a8b3c3a Compare May 19, 2026 16:41
donnchawp added 2 commits May 19, 2026 17:46
pnpm/action-setup@v4 was set to version: latest, which now pulls pnpm 11.
pnpm 11 changed where onlyBuiltDependencies is read from (moved out of
package.json) and made ignored builds a fatal install error
(ERR_PNPM_IGNORED_BUILDS), breaking the E2E install step.

Pin to pnpm v10 so the existing package.json "pnpm" field is honored and
the install completes. Avoids chasing pnpm 11's evolving config surface.
@donnchawp donnchawp merged commit a85a9d0 into trunk May 19, 2026
6 checks passed
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