Skip to content

feat(skills): add project management skill trilogy#52

Merged
jakewan merged 6 commits intomainfrom
feature/project-summary-skill
Mar 17, 2026
Merged

feat(skills): add project management skill trilogy#52
jakewan merged 6 commits intomainfrom
feature/project-summary-skill

Conversation

@jakewan
Copy link
Copy Markdown
Owner

@jakewan jakewan commented Mar 17, 2026

Overview

The purpose of this change is to add three Claude Code skills that provide structured project management — session orientation, backlog grooming, and milestone planning. This represents an incremental improvement that replaces ad-hoc gh issue list exploration with repeatable, layered workflows adapted from the emergent-sports project's skill hierarchy.

Layer Skill Role
Orientation /project-summary Where are we now?
Analysis /backlog-review What's in the backlog?
Planning /milestone-lifecycle What should we do next?

All three skills share a two-pass component classification heuristic (label match first, then title keywords) that maps issues to Finch's architectural layers (core, api, mcp, app, infra, dx). Each was tested by invocation during development, with refinements applied based on observed classification accuracy and structural gaps.

Key design decisions

  • Label-first classification: Labels (app-independence, github_actions, developer-experience) take precedence over title keyword matching to prevent misclassification when titles mention cross-cutting terms
  • Dependency graph gate logic: Uses Finch's core → api → mcp/app dependency chain instead of explicit critical-path labels
  • No deferred/tracking-issue concepts: Omitted features that depend on labels Finch doesn't have (deferred, epic, handoff)
  • Generic terminology: Avoids craft discipline vocabulary in public repo files
  • Phased approval gates: /milestone-lifecycle proposes gh commands but never auto-executes — every mutation requires explicit user confirmation

Closes #49
Closes #50
Closes #51

🤖 Generated with Claude Code

jakewan and others added 6 commits March 16, 2026 21:42
Adapted from emergent-sports reference implementation, tailored to
Finch's architecture layers and label taxonomy. Uses title/label
heuristics for component classification until component:* labels
are adopted.

Closes #49

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Label matches (app-independence, github_actions) now take precedence
over title keywords to prevent misclassification of app-layer issues
that mention core domain terms. Added missing keywords (account, debt,
interest, reflection, recipe, cash flow). Removed ambiguous "tool"
keyword from mcp — requires explicit "mcp" match.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Adapted from emergent-sports reference, tailored to Finch's
architecture and conventions. Reuses the two-pass component
classification heuristic from /project-summary. Omits deferred
issue handling and tracking issue logic (Finch has no equivalent
labels). Uses substantive activity dates for staleness instead of
updatedAt.

Closes #50

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Add developer-experience label → dx component mapping in Pass 1
of both skills, reducing the unclassified bucket. Refine the
decomposition heuristic in backlog-review to exclude checklists
under acceptance criteria headings, which are verification steps
rather than work items needing sub-issues.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Adapted from emergent-sports reference, tailored to Finch's
architecture and conventions. Uses component dependency graph
(core → api → mcp/app) for gate assessment instead of
critical-path labels. Phased execution commands with per-phase
approval gates ensure no autonomous state changes. Omits deferred
issue handling and tracking issue logic (no equivalent labels).

Closes #51

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Cold-start mode was skipping both Steps 3 and 4, but Step 5b
depends on the gate assessment from Step 4. The gate assessment
is independent of whether a milestone exists — it looks at open
issues by component in dependency order. Only Step 3 (completion
assessment) should be skipped in cold-start mode.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@jakewan jakewan marked this pull request as ready for review March 17, 2026 05:13
@jakewan jakewan merged commit 11874a6 into main Mar 17, 2026
2 checks passed
@jakewan jakewan deleted the feature/project-summary-skill branch March 17, 2026 05:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant