docs(linear): update documentation and prompt context for Linear PM integration

[aaight]

Summary

• Updated CLAUDE.md with Linear added to Integration Architecture Categories table, env vars section (LINEAR_API_KEY, LINEAR_WEBHOOK_SECRET), PM Agent Trigger Modes table, key directories, and a new Linear Integration section
• Updated src/integrations/README.md with Linear in the built-in integrations reference table and overview
• Updated docs/architecture/06-integration-layer.md with Linear as a PM provider in the credentials table, bootstrap section, and implementation section
• Added Linear tests to tests/unit/agents/shared/promptContext.test.ts verifying correct terminology (issues, teams, LINEAR-123 identifiers)

What was implemented

The Linear PM integration was already fully implemented in code (src/pm/linear/, src/linear/, src/triggers/linear/). This PR updates all documentation to reflect that Linear is now a supported PM provider alongside Trello and JIRA.

Changes by file

CLAUDE.md

• Updated trigger system diagram to include Linear
• Added src/linear/ to Key Directories
• Updated Integration Architecture Categories table to include Linear under pm
• Updated bootstrap count from "four" to "five" built-in integrations
• Added LINEAR_API_KEY and LINEAR_WEBHOOK_SECRET to project credentials description
• Updated project_integrations schema note to include linear as a provider
• Updated PM Agent Trigger Modes table: pm:status-changed now lists Trello, JIRA, Linear
• Added new Linear Integration section with credentials, configuration, and webhook setup

src/integrations/README.md

• Updated integration hierarchy overview to include Linear
• Updated bootstrap table count from 4 to 5
• Added linear row to Reference: built-in integrations table
• Clarified the step-by-step example note (Linear is now real, not hypothetical)

docs/architecture/06-integration-layer.md

• Updated IntegrationModule type comment to include 'linear'
• Updated bootstrap section to list LinearIntegration and count (five)
• Added Linear to Credential Roles table
• Added Linear provider implementation section

tests/unit/agents/shared/promptContext.test.ts

• Added describe('with Linear provider', ...) block with 8 test cases covering:
  • workItemNoun = "issue" for Linear
  • workItemNounPlural = "issues" for Linear
  • pmName = "Linear" for Linear
  • pmType = "linear"
  • Work item URL in https://linear.app/<org>/issue/<id> format
  • Pipeline list IDs read from linearConfig.statuses

Test plan

• All unit tests pass (npm test — 7431 tests)
• TypeScript compiles cleanly (npm run typecheck)
• Lint passes (npm run lint — 0 errors, 2 pre-existing warnings)
• New Linear prompt context tests pass (57 tests in promptContext.test.ts)

Trello card: https://trello.com/c/69de800a2e9fb083db973b00

🤖 Generated with Claude Code

🕵️ claude-code · claude-sonnet-4-6 · run details

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[nhopeatall]

LGTM — This is a clean documentation-and-tests PR that accurately reflects the already-implemented Linear integration. All referenced implementation files exist (src/pm/linear/, src/linear/, src/triggers/linear/, src/router/adapters/linear.ts), the bootstrap registration is in place, and the new tests correctly mirror the existing JIRA/Trello test structure. Documentation updates are consistent across CLAUDE.md, the integration layer docs, and the integrations README. CI is fully green.

🕵️ claude-code · claude-opus-4-6 · run details