#646 - Adopt Matt Pocock agent skills and restructure Claude Code config

[bracyw]

Changes

Adopts Matt Pocock's agent-skill framework as the AI-driven path for issue authoring and engineering work, and restructures the repo's Claude Code config to match. Lands in three groups: docs (agent config under docs/agents/, ADR 0002, a workflow glossary), skills (the 14 Matt skills plus the 7 Argos workflow skills, now tracked in .claude/skills/), and code rules (per-subdirectory CLAUDE.md for angular-client and scylla-server, a project-focused root CLAUDE.md, and pruned issue templates).

• Two-path issue authoring: AI files via Matt's body shapes through gh issue create, humans keep the YAML form templates; the ready-for-agent label distinguishes AI-filed issues. Rationale and the rejected single-path alternative are in docs/adr/0002-misc-adopt-matt-pocock-skills.md.
• commit, open-pr, and update-pr carry small labeled borrows from Matt's caveman and writing-shape skills: terser commit descriptions, plus a format-selection menu and a reader-filter pass for PR bodies.
• Five triage labels (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix) created on the repo; spike and other issue templates removed, leaving task, bug-form, feature-request, epic.

Notes

• This is the first committed CLAUDE.md in the repo. It is project-focused (overview, local dev, testing, conventions, safety, plus pointers to the subdir files) and deliberately omits the local bare-repo worktree workflow, which stays in the untracked worktrees-root CLAUDE.md and still parent-merges for that setup.
• The two subdir CLAUDE.md files port the former .claude/rules/ frontend and backend guidelines, minus the Cursor-style globs frontmatter that Claude Code ignores.
• Follow-ups, intentionally out of this PR: redesigning the worktree-root start-ticket skill to branch on the triage label (autonomous vs interactive), and a post-merge cleanup pass on the local worktree-root skill set.

Test Cases

• Confirmed the three commits group cleanly (docs / skills / code rules) with a clean working tree afterward: 54 files, no stray inclusions.
• Confirmed the 5 triage labels exist on the repo with the intended colors and descriptions.
• Confirmed no merge conflicts against develop.
• Spot-checked the migrated skill files and that the docs cross-references resolve.

Checklist

• All commits are tagged with the ticket number
• No linting errors / newline at end of file warnings
• All code follows repository-configured prettier formatting
• No merge conflicts
• All checks passing
• Remove any non-applicable sections of this template
• Assign the PR to yourself
• No package-lock.json changes (unless dependencies have changed)
• Request reviewers & ping on Slack
• PR is linked to the ticket (fill in the closes line below)

Closes #646

[TheJeffreyKuo]

leaks local

[TheJeffreyKuo]

relative pictures/ lands inside the worktree when run from one, which conflicts with the root CLAUDE.md which says screenshots live at worktrees-root, because it risks committing them

[TheJeffreyKuo]

qa skill doesn't exist