Skip to content

docs: clarify Linear utility commands and sync modes#13

Merged
shadowdevcode merged 1 commit intomainfrom
feat/linear-workflow-sync
Apr 1, 2026
Merged

docs: clarify Linear utility commands and sync modes#13
shadowdevcode merged 1 commit intomainfrom
feat/linear-workflow-sync

Conversation

@shadowdevcode
Copy link
Copy Markdown
Owner

Summary

  • Added inline descriptions to all 4 Linear utility commands in CLAUDE.md and README.md so they're scannable without reading the full command files
  • Replaced the numbered checkpoint list in README.md Linear PM Layer section with a decision table (stage → command → what it does)
  • Added inline comments to all Linear fields in project-state.md explaining what sets them and when they're populated
  • Registered linear-operations in the CLAUDE.md knowledge index comment

Test plan

  • Read CLAUDE.md utility commands section — Linear commands now self-describe
  • Read README.md Linear PM Layer section — decision table is clear and actionable
  • Read project-state.md Links section — all fields are annotated

🤖 Generated with Claude Code

- Add inline descriptions to all 4 Linear commands in CLAUDE.md and README.md
- Replace numbered list with decision table in README Linear PM Layer section
- Add inline comments to all Linear fields in project-state.md
- Register linear-operations in CLAUDE.md knowledge index

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel bot commented Apr 1, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ai-product-os-493e Ready Ready Preview, Comment Apr 1, 2026 10:37am

@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 1, 2026

PR Risk Assessment

Risk level: Medium

Reason: CLAUDE.md is a model instruction file; the addition of linear-operations (loaded only by Linear commands) to the knowledge index is a behavioral instruction (agent knowledge loading rule), not purely cosmetic. Requires human review before merge.

Action taken: No reviewers assigned — single-contributor repo, no eligible reviewers identifiable from git history. Human PM review required before merging.

@shadowdevcode shadowdevcode merged commit 6eaddba into main Apr 1, 2026
3 checks 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.

1 participant