feat: skill best practices audit improvements

[ducdmdev]

Summary

Addresses 5 improvements from auditing skills against the official Claude Code skill best practices.

• Split coordination-patterns.md (633 lines) into core (316) + advanced (332)
• Split teammate-roles.md (536 lines) into overview (168) + spawn-templates (407)
• Added concrete decomposition examples to agent-research, agent-audit, agent-plan skills
• Added table of contents to shared-phases.md (495 lines)
• Updated all cross-references across 11 files

Implemented by

Agent Team 0317-skill-best-practices (3 teammates: impl-splits, impl-examples, reviewer)

• Plan: docs/plans/2026-03-17-skill-best-practices-audit.md
• Workspace: .agent-team/0317-skill-best-practices/

Files changed (11)

File	Change
docs/coordination-patterns.md	Trimmed to core patterns (316 lines)
docs/coordination-advanced.md	New — advanced patterns (332 lines)
docs/teammate-roles.md	Trimmed to overview + selection guide (168 lines)
docs/spawn-templates.md	New — detailed spawn prompt templates (407 lines)
docs/shared-phases.md	Added TOC + cross-refs to new files (495 lines)
docs/team-archetypes.md	Re-plan ref → coordination-advanced.md
CLAUDE.md	Added new files to File Ownership table
README.md	Added new files to Plugin Structure tree
skills/agent-research/SKILL.md	Added React/Vue/Svelte comparison example
skills/agent-audit/SKILL.md	Added auth security audit example
skills/agent-plan/SKILL.md	Added microservices migration example

Test plan

• Full test suite: 97/98 pass (1 pre-existing claude plugin validate CLI issue)
• Doc reference tests: 19/19 pass — all cross-references resolve including new files
• Line count verification: all files under 500 lines
• Reviewer teammate validated all changes before merge