Skip to content

chore(skills): Update linear-project-status skill with more details & context#21234

Merged
mydea merged 1 commit into
developfrom
fn/update-linear-project-status
May 29, 2026
Merged

chore(skills): Update linear-project-status skill with more details & context#21234
mydea merged 1 commit into
developfrom
fn/update-linear-project-status

Conversation

@mydea
Copy link
Copy Markdown
Member

@mydea mydea commented May 29, 2026

Summary

Sharpens the linear-project-status skill so it's clearly a tool for project leads auditing their own projects, not a performance review of any individual. The verdict (Green/Yellow/Red) becomes a signal for the lead to interpret with context the audit can't see (PTO, competing priorities, work outside Linear) — not a grade.

Key changes

  • New "Audience and intent" section up front, making the framing explicit. Recommendations target the project's process ("add a target date", "split the milestone"), not people ("X needs to update more").
  • Lead engagement (dim 2b) reframed around whether the lead is finding time to engage with the project. Recognizes two healthy shapes — implementer (assigned to issues) and orchestrator (drives via updates / comments / milestones). A warn is explicitly not a critique.
  • Target date stability (dim 4) now weighs both push count and quality of explanation. Well-documented pushes (illness, dependency slip, scope change) → warn; vague or undocumented pushes → bad. Avoids over-penalising a lead who's transparent about slippage.
  • Target date presence/realism (dim 3) adds an explicit special-case block for "target date is today or past, project not Completed" — common enough to deserve direct handling.
  • Milestone health (dim 6) adds a distinct "tracking-hygiene gap" verdict for past-due milestones where the work clearly shipped but wasn't marked complete. The recommendation is cleanup, not a delivery concern.
  • Status update cadence (dim 1) now reads trajectory across the last ~6 weeks. Long silence followed by a fresh update → warn framed positively (the lead has already corrected course). Steady recent rhythm → ok even if there was an old gap further back. Don't dwell on distant history.
  • Scope stability (dim 7) carves out planned decomposition explicitly: when new issues share a common parentId, that's a structural breakdown of existing scope (healthy), not drift — never flag it.
  • "Reviewing people instead of the project" added as the top entry in the common failure modes list.

Validation

Iterated against two real Sentry projects (Hono SDK and Multi-Runtime Server Integrations) — each pass surfaced specific phrasings or rules that needed adjustment, which are now folded in.

🤖 Generated with Claude Code

… a people review

Sharpens the linear-project-status skill so it's clearly a tool for project leads
auditing their own projects, not a performance review of any individual.

Key changes:

- Add an "Audience and intent" section: the audience is the project lead, the
  verdict is a signal (not a grade), and the audit can't see PTO / competing
  priorities / work outside Linear — recommendations should target the project's
  process, not the people.
- Lead engagement (dim 2b) reframed around whether the lead is finding time to
  engage with the project. Explicitly recognizes two healthy shapes: implementer
  (assigned to issues) and orchestrator (drives via updates / comments /
  milestones). A `warn` is not a critique.
- Target date stability (dim 4) now weighs both push count and quality of
  explanation. Well-documented pushes (illness, scope change, dependency slip)
  earn `warn`; vague or undocumented pushes earn `bad`.
- Target date presence/realism (dim 3) adds a special-case block for "target
  date is today or past, project not Completed" — common enough to deserve
  explicit handling.
- Milestone health (dim 6) adds a distinct "tracking-hygiene gap" verdict for
  past-due milestones where the work clearly shipped but wasn't marked complete
  — the fix is cleanup, not a delivery concern.
- Status update cadence (dim 1) now reads trajectory across the last ~6 weeks.
  A long silence followed by a fresh update is `warn` with positive framing
  (recognize the correction). Steady recent rhythm is `ok` even if there was an
  old gap further back.
- Scope stability (dim 7) carves out planned decomposition: new issues sharing
  a common `parentId` are a structural breakdown of existing scope, not drift —
  never flag them.
- Common failure modes: "Reviewing people instead of the project" added as the
  top entry.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@mydea mydea changed the title chore(skills): Reframe linear-project-status as a project review, not a people review chore(skills): Update linear-project-status skill with more details & context May 29, 2026
@mydea mydea marked this pull request as ready for review May 29, 2026 07:31
@mydea mydea self-assigned this May 29, 2026
@mydea mydea requested review from chargome and s1gr1d May 29, 2026 07:31
@mydea mydea merged commit 3523df7 into develop May 29, 2026
37 checks passed
@mydea mydea deleted the fn/update-linear-project-status branch May 29, 2026 08:12
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.

3 participants