Skip to content

Fix: Convention improvement from issue #7#8

Merged
RasmusGodske merged 1 commit into
mainfrom
convention-improvement-issue-7
Nov 20, 2025
Merged

Fix: Convention improvement from issue #7#8
RasmusGodske merged 1 commit into
mainfrom
convention-improvement-issue-7

Conversation

@claude
Copy link
Copy Markdown

@claude claude Bot commented Nov 20, 2025

Summary

This PR implements the convention improvement proposed in issue #7 by adding a mandatory checkpoint for reviewing Linear project descriptions before creation.

Changes Made

File Modified: project-roles/skills/linear-project-management/SKILL.md

Added a new section "🚨 MANDATORY CHECKPOINT - Linear Project Creation" that:

  • Requires agents to invoke the linear-project-description-reviewer subagent before creating any Linear project
  • Enforces a clear workflow: draft → review → address feedback → create
  • Prevents agents from skipping the review step
  • Mirrors the code review pattern already used for engineering roles

Why This Improvement

Before this change, the skill provided excellent guidance on WHAT makes a good project description, but did not include a mandatory checkpoint to GET IT REVIEWED before creation. Without an explicit "STOP - invoke reviewer before creating" instruction, agents naturally proceeded straight to creating the project after drafting the description.

This checkpoint ensures every Linear project provides comprehensive context for Claude Code agents working on its issues, maintaining the same level of rigor as code reviews.

Related Issue

Fixes #7

🤖 Generated with Claude Code

Added a mandatory checkpoint to linear-project-management skill that requires
invoking the linear-project-description-reviewer agent before creating any
Linear project. This ensures all project descriptions are validated against
Linear conventions and provide comprehensive context for agents.

Changes:
- Added "🚨 MANDATORY CHECKPOINT - Linear Project Creation" section
- Enforces review workflow: draft → review → address feedback → create
- References linear-project-description-reviewer subagent
- Prevents agents from skipping review step

Implements convention improvement from issue #7.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@RasmusGodske RasmusGodske merged commit b68968c into main Nov 20, 2025
1 check 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.

[Convention] Missing checkpoint to review Linear project descriptions before creation

1 participant