
Linear Dev Accelerator
- 312 installs
- 61 repo stars
- Updated June 13, 2026
- manutej/luxor-claude-marketplace
Accelerate Linear issue triage, cycle planning, labeling, and execution workflows while coding so backlog stays organized and shippable.
About
Speeds development with Linear-centric PM workflows: structured issue creation, triage, cycle planning, labeling taxonomies, prioritization rituals, and execution habits that keep multi-project backlogs organized during active builds.
- Issue filing with consistent titles and labels
- Cycle and backlog prioritization rituals
- Tracer-bullet vertical slice breakdown
- Status updates tied to active development
- Solo-developer multi-project workspace patterns
Linear Dev Accelerator by the numbers
- 312 all-time installs (skills.sh)
- +18 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #877 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/manutej/luxor-claude-marketplace --skill linear-dev-acceleratorAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 312 |
|---|---|
| repo stars | ★ 61 |
| Last updated | June 13, 2026 |
| Repository | manutej/luxor-claude-marketplace ↗ |
What it does
Accelerate Linear issue triage, cycle planning, labeling, and execution workflows while coding so backlog stays organized and shippable.
Files
Linear Development Accelerator
A comprehensive skill for accelerating software development using Linear project management with MCP server integration. This skill enables rapid project setup, intelligent issue management, and streamlined development workflows for web and mobile applications.
When to Use This Skill
Use this skill when:
- Starting a new software development project and need to set up Linear project management
- Managing issues, tasks, and features for frontend, backend, or full-stack applications
- Organizing development work into sprints/cycles with proper tracking
- Collaborating with development teams on software projects
- Automating project management tasks during development
- Tracking bugs, features, and technical debt systematically
- Building applications with structured project management workflows
- Integrating Linear with GitHub for PR-based development
Core Concepts
Linear Project Management Philosophy
Linear emphasizes speed, clarity, and focus for software teams:
- Issues as First-Class Citizens: Every unit of work is an issue with rich metadata
- Cycles for Sprint Planning: Time-boxed iterations for focused execution
- Projects for Product Planning: Higher-level initiatives and roadmaps
- Teams for Organization: Workspaces for different functions or products
- Workflows for Process: Custom statuses matching your development process
Key Linear Entities
1. Teams: Organizational units (e.g., Frontend, Backend, Mobile) 2. Issues: Individual tasks, bugs, features, or improvements 3. Projects: Collections of related issues for larger initiatives 4. Cycles: Time-boxed iterations (similar to sprints) 5. Labels: Categorization and filtering mechanism 6. Statuses: Issue states (Backlog, Todo, In Progress, In Review, Done, Canceled) 7. Comments: Collaboration and discussion on issues 8. Documents: Long-form documentation integrated with issues
MCP Server Tools Reference
Issue Management
list_issues
List and filter issues in your workspace.
Common Parameters:
team: Team name or ID
assignee: User ID, name, email, or "me" for your issues
state: Status name or ID (e.g., "In Progress", "Done")
label: Label name or ID for filtering
project: Project name or ID
query: Search in title/description
limit: Number of results (max 250, default 50)
orderBy: "createdAt" or "updatedAt" (default)
includeArchived: Include archived issues (default: true)Examples:
# Get my current issues
assignee: "me"
state: "In Progress"
limit: 10
# Find bugs in a specific project
label: "bug"
project: "Mobile App"
state: "Todo"
# Search for authentication-related issues
query: "authentication"
team: "Backend"create_issue
Create a new issue with full metadata.
Required Parameters:
title: Issue title (clear and concise)
team: Team name or IDOptional Parameters:
description: Markdown description with details
assignee: User ID, name, email, or "me"
state: State type, name, or ID
priority: 0=None, 1=Urgent, 2=High, 3=Normal, 4=Low
labels: Array of label names or IDs
project: Project name or ID
cycle: Cycle name, number, or ID
parentId: Parent issue ID for sub-issues
dueDate: ISO format date
links: Array of {url, title} objectsExample:
title: "Implement user authentication"
team: "Backend"
description: |
## Overview
Add JWT-based authentication to the API
## Tasks
- [ ] Design auth flow
- [ ] Implement JWT tokens
- [ ] Add refresh token logic
- [ ] Write tests
## Acceptance Criteria
- Secure token generation
- Token expiration handling
- Proper error responses
assignee: "me"
priority: 2 # High
labels: ["feature", "authentication", "backend"]
project: "API v2.0"update_issue
Update an existing issue.
Required: id (issue ID)
Updatable Fields:
title, description, assignee, state, priority, labels,
project, cycle, parentId, dueDate, estimate, linksExample:
id: "issue-uuid-here"
state: "In Progress"
assignee: "me"
labels: ["feature", "in-development"]get_issue
Get detailed issue information including attachments and git branch.
Parameters:
id: Issue IDReturns: Full issue details with attachments, git branch name, related data
Project Management
list_projects
List and filter projects.
Parameters:
team: Team name or ID
state: State name or ID
member: User ID, name, email, or "me"
initiative: Initiative name or ID
query: Search project names
limit: Number of results (max 250, default 50)
orderBy: "createdAt" or "updatedAt"
includeArchived: Include archived (default: false)create_project
Create a new project.
Required Parameters:
name: Project name
team: Team name or IDOptional Parameters:
description: Full Markdown description
summary: Concise plaintext summary (max 255 chars)
lead: Project lead (User ID, name, email, or "me")
state: Project state
priority: 0-4 (None, Urgent, High, Medium, Low)
startDate: ISO format date
targetDate: ISO format date
labels: Array of label names or IDsExample:
name: "Mobile App v2.0"
team: "Mobile"
summary: "Complete redesign of mobile app with new features"
description: |
# Mobile App v2.0
## Goals
- Modern UI/UX redesign
- Offline-first architecture
- Push notifications
- Real-time sync
## Timeline
Q1 2025 - Design & Planning
Q2 2025 - Development
Q3 2025 - Testing & Launch
lead: "me"
priority: 2
startDate: "2025-01-15"
targetDate: "2025-09-30"
labels: ["mobile", "redesign", "major-release"]update_project
Update existing project details.
Required: id (project ID)
Updatable: name, description, summary, lead, state, priority, startDate, targetDate, labels
get_project
Get detailed project information.
Parameters:
query: Project ID or nameLabels & Categorization
list_issue_labels
List available labels.
Parameters:
team: Team name or ID (optional, for team-specific labels)
name: Filter by label name
limit: Number of results (max 250)
orderBy: "createdAt" or "updatedAt"create_issue_label
Create new label for categorization.
Required:
name: Label nameOptional:
color: Hex color code (e.g., "#10B981")
description: Label description
teamId: Team UUID (omit for workspace label)
isGroup: true for label groups (default: false)
parentId: Parent label UUID for hierarchical labelsExample:
name: "frontend"
color: "#3B82F6"
description: "Frontend-related tasks and features"
teamId: "team-uuid-here"Workflow & Status Management
list_issue_statuses
List available statuses for a team.
Parameters:
team: Team name or ID (required)Returns: Array of statuses with id, type, name
- Types: backlog, unstarted, started, completed, canceled
get_issue_status
Get detailed status information.
Parameters:
id: Status ID
name: Status name
team: Team name or ID (required)Collaboration
list_comments
List comments on an issue.
Parameters:
issueId: Issue ID (required)create_comment
Add comment to an issue.
Parameters:
issueId: Issue ID (required)
body: Markdown comment content (required)
parentId: Parent comment ID for replies (optional)Example:
issueId: "issue-uuid-here"
body: |
Great progress! A few notes:
- Consider edge case for expired tokens
- Add integration test for refresh flow
- Document the auth header formatTeam & User Management
list_teams
List all teams in workspace.
Parameters:
query: Search query (optional)
limit: Number of results (max 250)
includeArchived: Include archived teams (default: false)get_team
Get detailed team information.
Parameters:
query: Team UUID, key, or namelist_users
List users in workspace.
Parameters:
query: Filter by name or email (optional)get_user
Get user details.
Parameters:
query: User ID, name, email, or "me"Cycles (Sprint Planning)
list_cycles
Get cycles for a team.
Parameters:
teamId: Team ID (required)
type: "current", "previous", "next", or omit for allDocumentation
list_documents
List Linear documents.
Parameters:
query: Search query
creatorId: Creator user ID
projectId: Project ID
initiativeId: Initiative ID
limit: Number of results (max 250)
orderBy: "createdAt" or "updatedAt"
includeArchived: Include archived (default: false)get_document
Get document by ID or slug.
Parameters:
id: Document ID or slugDevelopment Workflow Patterns
Pattern 1: New Feature Development
Scenario: Building a new feature for a web application
1. Create feature issue
- Use create_issue with:
- Clear title: "Add dark mode toggle"
- Detailed description with tasks and acceptance criteria
- Assign to yourself or team member
- Add labels: ["feature", "frontend", "ui"]
- Link to project: "Q1 Features"
- Set priority based on urgency
2. Break down into sub-tasks (if complex)
- Create child issues with parentId
- Each sub-task is a manageable unit of work
- Example sub-tasks:
- "Design dark mode color scheme"
- "Implement theme context in React"
- "Add toggle button component"
- "Persist theme preference"
3. Track progress
- Update issue state as you work:
- Todo → In Progress → In Review → Done
- Add comments with updates and blockers
- Link PR when ready for review
4. Complete and review
- Update state to "In Review"
- Add links to PR, deployed preview
- Mark as Done when merged and deployedPattern 2: Bug Triage and Fix
Scenario: Handling bug reports efficiently
1. Create bug issue
- title: Clear description of the bug
- description: Steps to reproduce, expected/actual behavior
- labels: ["bug", "priority:high"] if critical
- assignee: Developer responsible for that area
- Add links to error logs, screenshots
2. Investigation
- Update to "In Progress"
- Add comments with findings
- Link to related issues if discovered
- Update priority if needed
3. Fix implementation
- Reference issue in commit messages
- Link PR to issue
- Add comment explaining fix approach
4. Verification and closure
- State: "In Review" during QA
- State: "Done" after verification
- Add comment confirming fix is deployedPattern 3: Sprint/Cycle Planning
Scenario: Planning a 2-week development cycle
1. Review backlog
- list_issues with state: "Backlog"
- Filter by priority and labels
- Identify issues ready for development
2. Create or select cycle
- list_cycles to see current cycle
- Organize selected issues into cycle
3. Assign and prioritize
- Distribute issues across team
- Set priorities: Urgent (1) → High (2) → Normal (3)
- Balance workload across team members
4. Daily tracking
- list_issues with assignee: "me", state: "In Progress"
- Update issue states as work progresses
- Add comments for standup updates
- Move blocked issues back to Todo
5. Cycle review
- List completed issues in cycle
- Review metrics (velocity, completion rate)
- Move incomplete issues to next cycle or backlogPattern 4: Project Setup for New Application
Scenario: Starting a new mobile app project
1. Create project
- name: "Mobile App - iOS & Android"
- description: Full project scope, goals, timeline
- Set lead, dates, labels
- Link to design docs, PRD
2. Set up project structure
- Create initial issues for setup:
- "Setup React Native project"
- "Configure CI/CD pipeline"
- "Design component architecture"
- "Setup state management"
- Assign to team members
- Add to project
3. Create epics (major features)
- Authentication system
- User profile management
- Core app functionality
- Push notifications
- Each epic is a parent issue with sub-issues
4. Organize into cycles
- Cycle 1: Project setup & architecture
- Cycle 2-3: Core features
- Cycle 4: Polish & testing
- Assign issues to appropriate cycles
5. Track progress
- Update project description with status
- Weekly reviews with get_project
- Adjust priorities and timeline as neededPattern 5: GitHub Integration Workflow
Scenario: Linking Linear issues with GitHub PRs
1. Create issue in Linear
- Get git branch name from issue: issue.gitBranchName
- Example: "cetiaiservices/cet-95-create-benchmark-methodology-guide"
2. Create branch using Linear's suggested name
- Ensures automatic linking
- Linear tracks PR status automatically
3. Development
- Commit with Linear issue reference: "CET-95: Add benchmark docs"
- Linear updates issue automatically when PR created
4. Code review
- PR opened → Linear sets state to "In Review"
- Comments on PR can sync to Linear
- Review feedback tracked in both systems
5. Merge and deploy
- PR merged → Linear can auto-complete issue
- Deployment triggers update Linear with links
- Full traceability from issue → PR → deploymentAccelerated Development Strategies
Strategy 1: Batch Issue Creation
When starting a project, create all known issues in one go:
// Create multiple related issues
const features = [
"User registration and login",
"Password reset flow",
"Email verification",
"Social auth (Google, GitHub)",
"Two-factor authentication"
];
// For each feature, create issue with:
- Consistent labeling: ["auth", "feature"]
- Link to parent project: "Authentication System"
- Assign to team members based on expertise
- Set due dates based on project timelineStrategy 2: Smart Filtering for Focus
Use filters to reduce cognitive load:
// Morning: What do I need to work on today?
assignee: "me"
state: "In Progress"
orderBy: "updatedAt"
// Planning: What's in the backlog for my team?
team: "Frontend"
state: "Backlog"
priority: 2 // High priority items
labels: ["ready-for-dev"]
// Review: What needs my attention?
assignee: "me"
state: "In Review"
orderBy: "createdAt" // Oldest firstStrategy 3: Template-Based Issue Creation
Create consistent issues using templates:
// Bug report template
title: "[BUG] {concise description}"
description: |
## Bug Description
{What's wrong?}
## Steps to Reproduce
1. {Step 1}
2. {Step 2}
3. {Step 3}
## Expected Behavior
{What should happen}
## Actual Behavior
{What actually happens}
## Environment
- Browser: {browser}
- OS: {OS}
- Version: {version}
## Additional Context
{Screenshots, logs, etc.}
labels: ["bug", "needs-triage"]
priority: 3 // Default to normal, adjust after triage
// Feature request template
title: "[FEATURE] {feature name}"
description: |
## Feature Description
{What feature do you want?}
## User Story
As a {user type}
I want {goal}
So that {benefit}
## Acceptance Criteria
- [ ] {Criterion 1}
- [ ] {Criterion 2}
- [ ] {Criterion 3}
## Design Notes
{Link to designs, wireframes}
## Technical Notes
{Implementation considerations}
labels: ["feature", "needs-refinement"]Strategy 4: Automated Status Updates
Update issues as part of your development workflow:
// In CI/CD pipeline:
- Tests passing → Add comment with test results
- Deploy to staging → Update with staging URL
- Deploy to production → Mark as Done, add production URL
// In git hooks:
- Pre-commit: Verify issue reference in commit message
- Post-merge: Update Linear issue status
- Tag creation: Link release to completed issuesStrategy 5: Cross-Functional Coordination
Use Linear for coordinating frontend/backend/mobile work:
// Create parent issue for full-stack feature
Parent: "User Dashboard Feature"
├─ Child: "[Backend] Dashboard API endpoints"
│ └─ labels: ["backend", "api"]
├─ Child: "[Frontend] Dashboard React components"
│ └─ labels: ["frontend", "react"]
└─ Child: "[Mobile] Dashboard mobile screens"
└─ labels: ["mobile", "flutter"]
// Track dependencies
- Backend issue must complete first
- Frontend/Mobile can work in parallel after API ready
- Use "blocked" relation type to track dependenciesBest Practices
Issue Creation
1. Clear Titles: Start with verb (Add, Fix, Update, Refactor) 2. Rich Descriptions: Use markdown, checklists, code blocks 3. Proper Labeling: Consistent label taxonomy 4. Right Sizing: Issues should be completable in 1-3 days 5. Acceptance Criteria: Always define "done"
Project Organization
1. One Project Per Initiative: Don't create too many projects 2. Use Labels for Categorization: More flexible than projects 3. Regular Cleanup: Archive completed projects 4. Clear Ownership: Every project needs a lead 5. Linked Documentation: Keep project descriptions updated
Workflow Management
1. Limit Work in Progress: Max 3 "In Progress" issues per person 2. Update Status Promptly: Keep issues current 3. Use Comments Liberally: Document decisions and blockers 4. Link Related Issues: Build context through relations 5. Complete Issues Fully: Don't leave zombie issues
Team Collaboration
1. Assign Clearly: Every issue should have one owner 2. Use @mentions: Tag people in comments for visibility 3. Regular Reviews: Weekly project/cycle reviews 4. Celebrate Wins: Mark milestones and achievements 5. Share Context: Link to PRs, docs, designs
Label Taxonomy
Recommended label categories:
Type Labels:
- feature, bug, improvement, docs, refactor, test
Priority Labels:
- priority:urgent, priority:high, priority:normal, priority:low
Area Labels:
- frontend, backend, mobile, devops, design, qa
Status Labels:
- blocked, ready-for-dev, needs-review, waiting-on-qa
Technology Labels:
- react, flutter, python, node, postgres, redisIntegration with Development Tools
GitHub Integration
- Use Linear's suggested git branch names
- Reference Linear issues in commit messages: "CET-123: Add feature"
- PRs automatically link to Linear issues
- PR status updates Linear issue status
- Merge events can auto-complete issues
CI/CD Integration
- Post test results as comments on Linear issues
- Update issues on deploy events
- Link deployment URLs in issue comments
- Track deployment status per issue
Slack Integration
- Get notifications for assigned issues
- Update Linear from Slack
- Share issue links in team channels
- Daily standup reminders with your issues
Common Workflows for Application Types
Frontend Application Development
1. Design → Development workflow:
- Create issue from design handoff
- labels: ["frontend", "ui", "design-ready"]
- Link to Figma/design files
- Break into component-level issues
2. Component development:
- Parent: "User Profile Page"
├─ "ProfileHeader component"
├─ "ProfileStats component"
├─ "ProfileSettings component"
└─ "Profile routing and layout"
3. Integration and testing:
- Create issues for:
- Integration testing
- Accessibility audit
- Performance optimization
- Browser compatibility testingFull-Stack Application Development
1. Feature planning:
- Parent issue: "Payment Processing Feature"
- Children:
- Database schema design
- API endpoint implementation
- Frontend payment form
- Payment provider integration
- Error handling and logging
- Testing (unit, integration, E2E)
2. Parallel development:
- Backend team: API and database
- Frontend team: UI components (mocked API)
- Coordinate through Linear comments
- Track blockers and dependencies
3. Integration phase:
- Create integration testing issue
- Link all related issues
- Coordinate deploymentMobile Application Development
1. Platform-specific tracking:
- labels: ["ios", "android", "shared"]
- Track platform-specific bugs separately
- Share code issues labeled "shared"
2. Release management:
- Project per release: "iOS v2.1.0"
- Issues per feature/fix in release
- Track App Store/Play Store submissions
- Link to release notes
3. Testing workflow:
- Device testing: Track per device type
- OS version compatibility
- Performance on different hardware
- Beta testing feedbackTroubleshooting
Common Issues
Issue not appearing in filters
- Check if archived: Set includeArchived: true
- Verify team name/ID is correct
- Check status matches expected state
Cannot create issue
- Ensure team parameter is provided (required)
- Verify label names exist if using labels
- Check project name/ID is valid
- Ensure assignee exists in workspace
Cannot update issue
- Verify issue ID is correct (use get_issue first)
- Check you have permission to modify issue
- Ensure state name is valid (use list_issue_statuses)
- Verify label names exist
Projects not loading
- Check includeArchived setting
- Verify team filter is correct
- Try without filters to see all projects
Advanced Usage
Automated Project Setup
Create a complete project structure programmatically:
1. Create project
2. Create label set for project
3. Create epic issues (parent issues)
4. Create sub-issues for each epic
5. Assign issues to team members
6. Organize into first cycle
7. Generate project documentationMetrics and Reporting
Track development metrics:
// Velocity tracking
- Issues completed per cycle
- Average time to complete
- Blockers frequency
// Quality metrics
- Bug rate per feature
- Time to fix bugs
- Reopened issues
// Team metrics
- Issues per team member
- Workload balance
- Completion ratesCustom Workflows
Design workflows matching your process:
// Example: Feature flag workflow
States:
1. Backlog (unstarted)
2. Ready for Dev (unstarted)
3. In Development (started)
4. In Review (started)
5. In QA (started)
6. Deployed with Flag (started)
7. Flag Enabled (started)
8. Monitoring (started)
9. Flag Removed (completed)
10. Done (completed)Quick Reference
Essential Shortcuts
My active work:
assignee: "me", state: "In Progress"
Team backlog:
team: "{team-name}", state: "Backlog", orderBy: "updatedAt"
High priority issues:
priority: 2, state: "Todo", orderBy: "createdAt"
Recently updated:
orderBy: "updatedAt", limit: 20
Bugs needing triage:
label: "bug", state: "Backlog", orderBy: "createdAt"Issue Creation Template
title: "[TYPE] Clear, actionable title"
description: |
## Overview
{What and why}
## Tasks
- [ ] Task 1
- [ ] Task 2
## Acceptance Criteria
- Criterion 1
- Criterion 2
team: "{team-name}"
assignee: "me"
labels: ["{type}", "{area}", "{priority}"]
project: "{project-name}"
priority: 3Resources
- Linear Documentation: https://linear.app/docs
- Linear API Reference: https://developers.linear.app/docs
- Linear Blog: https://linear.app/blog
- GitHub Integration Guide: https://linear.app/docs/github
- Linear Keyboard Shortcuts: linear.app/shortcuts
---
Skill Version: 1.0.0 Last Updated: October 2025 Skill Category: Project Management, Development Acceleration, Team Collaboration Compatible With: Linear MCP Server, GitHub, CI/CD pipelines
Frontend Project Setup Example
Complete workflow for setting up a new React frontend project in Linear.
Step 1: Create the Project
Tool: create_project
Parameters:
name: "E-Commerce Frontend Redesign"
team: "Frontend"
summary: "Complete UI/UX redesign of e-commerce platform with modern React architecture"
description: |
# E-Commerce Frontend Redesign
## Project Goals
- Modernize UI/UX with contemporary design system
- Improve performance (target: < 2s load time)
- Implement responsive design for mobile/tablet
- Add dark mode support
- Improve accessibility (WCAG 2.1 AA compliance)
## Tech Stack
- React 18 with TypeScript
- Tailwind CSS for styling
- Zustand for state management
- React Query for data fetching
- Vite for build tooling
## Timeline
- Q1 2025: Planning & Architecture (Weeks 1-2)
- Q1 2025: Core Components (Weeks 3-6)
- Q2 2025: Feature Implementation (Weeks 7-10)
- Q2 2025: Testing & Polish (Weeks 11-12)
## Success Metrics
- Lighthouse score > 90
- Core Web Vitals in "Good" range
- Zero critical accessibility issues
- 50% reduction in bundle size
lead: "me"
priority: 2
startDate: "2025-01-15"
targetDate: "2025-04-15"
labels: ["frontend", "redesign", "react"]Step 2: Create Foundation Issues
Architecture & Setup
Tool: create_issue
Issue 1 - Project Setup:
title: "Setup React + TypeScript + Vite project"
team: "Frontend"
description: |
## Tasks
- [ ] Initialize Vite project with React + TS template
- [ ] Configure ESLint and Prettier
- [ ] Setup Tailwind CSS
- [ ] Configure path aliases
- [ ] Setup Git hooks with Husky
- [ ] Configure environment variables
## Acceptance Criteria
- Project builds successfully
- Linting and formatting work
- Hot reload functions correctly
- Sample page renders
assignee: "me"
project: "E-Commerce Frontend Redesign"
labels: ["setup", "infrastructure", "frontend"]
priority: 1Issue 2 - Design System:
title: "Implement design system foundation"
team: "Frontend"
description: |
## Overview
Create reusable design system components and tokens
## Tasks
- [ ] Define color palette (light/dark modes)
- [ ] Setup typography scale
- [ ] Create spacing and sizing tokens
- [ ] Build primitive components (Button, Input, Card)
- [ ] Document components in Storybook
- [ ] Setup design tokens export
## Resources
- Figma: [link to design file]
## Acceptance Criteria
- All primitive components documented
- Dark mode variants work correctly
- Accessibility features included
- Storybook deployed
assignee: "designer-name"
project: "E-Commerce Frontend Redesign"
labels: ["design-system", "ui", "frontend"]
priority: 2Step 3: Create Feature Epics
Epic 1: Product Catalog
Tool: create_issue
Parent Issue:
title: "[EPIC] Product Catalog Redesign"
team: "Frontend"
description: |
## Overview
Redesign product browsing and discovery experience
## Features
- Product grid with infinite scroll
- Advanced filtering and sorting
- Product quick view
- Wishlist functionality
- Product comparisons
## Design
[Link to Figma designs]
## Acceptance Criteria
- All features implemented and tested
- Performance targets met
- Accessibility compliant
- Mobile responsive
project: "E-Commerce Frontend Redesign"
labels: ["epic", "product-catalog", "frontend"]
priority: 2Now create child issues:
Tool: create_issue
Child Issue 1:
title: "Product Grid Component"
team: "Frontend"
description: |
## Tasks
- [ ] Create ProductCard component
- [ ] Implement grid layout with Tailwind
- [ ] Add image lazy loading
- [ ] Implement infinite scroll
- [ ] Add loading skeletons
## Acceptance Criteria
- Renders 100+ products smoothly
- Images lazy load correctly
- Infinite scroll works on all devices
- Skeleton states during loading
parentId: "[epic-issue-id]"
assignee: "frontend-dev-1"
project: "E-Commerce Frontend Redesign"
labels: ["frontend", "component", "product-catalog"]
priority: 2Child Issue 2:
title: "Product Filtering System"
team: "Frontend"
description: |
## Tasks
- [ ] Create FilterPanel component
- [ ] Implement category filters
- [ ] Add price range slider
- [ ] Implement rating filter
- [ ] Add search within results
- [ ] URL state management for filters
## Acceptance Criteria
- Filters update URL query params
- Back button works correctly
- Filter combinations work properly
- Mobile filter drawer implemented
parentId: "[epic-issue-id]"
assignee: "frontend-dev-2"
project: "E-Commerce Frontend Redesign"
labels: ["frontend", "filtering", "product-catalog"]
priority: 2Epic 2: Shopping Cart
Tool: create_issue
Parent Issue:
title: "[EPIC] Shopping Cart Experience"
team: "Frontend"
description: |
## Overview
Modern shopping cart with real-time updates
## Features
- Cart sidebar/drawer
- Quantity adjustments
- Remove items
- Apply coupon codes
- Shipping calculator
- Cart persistence
## Acceptance Criteria
- Cart state persists across sessions
- Real-time price calculations
- Optimistic updates
- Error handling
project: "E-Commerce Frontend Redesign"
labels: ["epic", "cart", "frontend"]
priority: 1Step 4: Organize Into Cycles
Cycle 1: Foundation (Weeks 1-2)
Tool: list_cycles
Parameters:
teamId: "frontend-team-id"
type: "current"
Then update issues:
Tool: update_issue
Parameters:
id: "[project-setup-issue-id]"
cycle: "[cycle-1-id]"
Repeat for:
- Project setup issue
- Design system issue
- Architecture documentation issueCycle 2: Product Catalog (Weeks 3-4)
Add to cycle:
- Product Grid Component
- Product Filtering System
- Product Detail Page
- Wishlist FeatureCycle 3: Shopping & Checkout (Weeks 5-6)
Add to cycle:
- Cart implementation
- Checkout flow
- Payment integration
- Order confirmationStep 5: Track Progress
Daily Stand-up Query
Tool: list_issues
Get my tasks:
assignee: "me"
state: "In Progress"
project: "E-Commerce Frontend Redesign"
limit: 10Sprint Review Query
Tool: list_issues
Completed this cycle:
project: "E-Commerce Frontend Redesign"
state: "Done"
orderBy: "updatedAt"
limit: 50Blocked Issues Query
Tool: list_issues
Find blockers:
project: "E-Commerce Frontend Redesign"
label: "blocked"
state: "In Progress"Step 6: Issue Updates During Development
Starting Work
Tool: update_issue
Parameters:
id: "[issue-id]"
state: "In Progress"
assignee: "me"Adding Progress Comments
Tool: create_comment
Parameters:
issueId: "[issue-id]"
body: |
## Progress Update
### Completed
- ✅ Created ProductCard component
- ✅ Implemented grid layout
- ✅ Added image lazy loading
### In Progress
- 🔄 Implementing infinite scroll
- 🔄 Adding skeleton loading states
### Blockers
- Waiting on image CDN configuration
### Next Steps
- Complete infinite scroll
- Add unit tests
- Performance optimizationLinking PR
Tool: update_issue
Parameters:
id: "[issue-id]"
state: "In Review"
links: [
{
url: "https://github.com/company/ecommerce/pull/123",
title: "PR: Product Grid Component"
}
]Completing Issue
Tool: update_issue
Parameters:
id: "[issue-id]"
state: "Done"Tool: create_comment
Parameters:
issueId: "[issue-id]"
body: |
## Completion Summary
✅ All acceptance criteria met
✅ PR merged: #123
✅ Deployed to staging: https://staging.example.com
✅ QA approved
### Metrics
- Bundle size: +12KB (within budget)
- Lighthouse: 95/100
- Test coverage: 87%
### Documentation
- Storybook: https://storybook.example.com/product-grid
- Component docs updatedStep 7: Project-Level Updates
Weekly Project Update
Tool: update_project
Parameters:
id: "[project-id]"
description: |
# E-Commerce Frontend Redesign
## Status: On Track ✅
**Week 4 of 12 - End of Cycle 2**
## Progress
- Product Catalog: 75% complete
- Design System: 100% complete
- Shopping Cart: 25% complete
## Completed This Week
- ✅ Product Grid Component
- ✅ Filtering System
- ✅ Product Quick View
## Next Week
- Cart Drawer Component
- Checkout Flow Design
- Payment Integration Planning
## Metrics
- Issues Completed: 12/45 (27%)
- On Schedule: Yes
- Performance: Meeting targets
## Risks
- ⚠️ Waiting on API updates for wishlist feature
- Mitigation: Mock API ready, can proceed
[Previous content preserved...]Result
After this setup, you have:
- 1 Well-defined project
- 2-3 Epic issues (parent issues)
- 15-20 Feature issues (child issues)
- Clear ownership and assignments
- Organized into 3-4 cycles
- Tracking structure in place
- Ready to start development with full visibility
Tips
1. Create issues in batches: Don't create all at once, add as you learn 2. Update regularly: Keep Linear current with development status 3. Use comments: Document decisions and context 4. Link everything: PRs, docs, designs, deployments 5. Review weekly: Update project description with status 6. Celebrate wins: Mark milestones and completed features
Full-Stack API Development Workflow
Managing backend API and frontend integration with Linear for accelerated development.
Project: RESTful API with React Frontend
Project Setup
Tool: create_project
Parameters:
name: "Task Management API + Web App"
team: "Full-Stack"
summary: "Complete task management system with Node.js API and React frontend"
description: |
# Task Management API + Web App
## Architecture
- **Backend**: Node.js + Express + PostgreSQL
- **Frontend**: React + TypeScript + Tailwind
- **API**: RESTful with JWT authentication
- **Deployment**: Docker + AWS
## Features
- User authentication and authorization
- Task CRUD operations
- Project organization
- Real-time updates with WebSockets
- File attachments
- Team collaboration
## Development Approach
- API-first development
- Parallel frontend/backend work
- Comprehensive API documentation
- E2E testing
## Timeline
- Weeks 1-2: Database + Auth API
- Weeks 3-4: Task API + Frontend Integration
- Weeks 5-6: Real-time features + Polish
lead: "me"
priority: 1
startDate: "2025-01-15"
targetDate: "2025-03-01"
labels: ["full-stack", "api", "backend", "frontend"]Phase 1: Backend API Development
Epic: Authentication System
Tool: create_issue
Parent Issue:
title: "[EPIC][Backend] Authentication & Authorization API"
team: "Backend"
description: |
## API Endpoints
- POST /api/auth/register
- POST /api/auth/login
- POST /api/auth/logout
- POST /api/auth/refresh
- POST /api/auth/forgot-password
- POST /api/auth/reset-password
- GET /api/auth/me
## Features
- JWT token generation
- Refresh token rotation
- Password hashing (bcrypt)
- Email verification
- Rate limiting
- CORS configuration
## Security
- Input validation
- SQL injection prevention
- XSS protection
- CSRF tokens
## Documentation
- OpenAPI/Swagger spec
- Postman collection
- API integration guide
project: "Task Management API + Web App"
labels: ["epic", "backend", "auth", "api"]
priority: 1Breaking Down Backend Work
Issue 1: Database Schema
title: "[Backend] User authentication database schema"
team: "Backend"
description: |
## Tables
### usersCREATE TABLE users ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), email VARCHAR(255) UNIQUE NOT NULL, password_hash VARCHAR(255) NOT NULL, first_name VARCHAR(100), last_name VARCHAR(100), email_verified BOOLEAN DEFAULT FALSE, created_at TIMESTAMP DEFAULT NOW(), updated_at TIMESTAMP DEFAULT NOW() );
### refresh_tokensCREATE TABLE refresh_tokens ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), user_id UUID REFERENCES users(id) ON DELETE CASCADE, token VARCHAR(255) UNIQUE NOT NULL, expires_at TIMESTAMP NOT NULL, created_at TIMESTAMP DEFAULT NOW() );
### password_resetsCREATE TABLE password_resets ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), user_id UUID REFERENCES users(id) ON DELETE CASCADE, token VARCHAR(255) UNIQUE NOT NULL, expires_at TIMESTAMP NOT NULL, used BOOLEAN DEFAULT FALSE, created_at TIMESTAMP DEFAULT NOW() );
## Indexes
- users.email (unique)
- refresh_tokens.token (unique)
- refresh_tokens.user_id
- password_resets.token (unique)
## Acceptance Criteria
- Migration file created
- Schema documented
- Indexes optimized
- Foreign keys properly set
parentId: "[auth-epic-id]"
assignee: "backend-dev-1"
project: "Task Management API + Web App"
labels: ["backend", "database", "schema"]
priority: 1Issue 2: Authentication Endpoints
title: "[Backend] Implement auth API endpoints"
team: "Backend"
description: |
## Endpoints to Implement
### POST /api/auth/register
Request:{ "email": "user@example.com", "password": "SecurePass123!", "firstName": "John", "lastName": "Doe" }
Response: User object + tokens
### POST /api/auth/login
Request:{ "email": "user@example.com", "password": "SecurePass123!" }
Response: User object + tokens
### POST /api/auth/refresh
Request:{ "refreshToken": "..." }
Response: New access + refresh tokens
## Implementation Tasks
- [ ] Password validation rules
- [ ] Email format validation
- [ ] Bcrypt password hashing
- [ ] JWT token generation
- [ ] Refresh token rotation
- [ ] Error handling
- [ ] Rate limiting (5 attempts/minute)
## Security Checklist
- [ ] Passwords never logged
- [ ] Tokens properly signed
- [ ] Secure HTTP headers
- [ ] Input sanitization
## Testing
- [ ] Unit tests for each endpoint
- [ ] Integration tests
- [ ] Security tests
- [ ] Load tests
## Acceptance Criteria
- All endpoints working
- Tests passing
- OpenAPI documented
- Postman collection updated
parentId: "[auth-epic-id]"
assignee: "backend-dev-1"
project: "Task Management API + Web App"
labels: ["backend", "api", "auth"]
priority: 1
links: [
{
url: "https://github.com/company/api/blob/main/docs/auth.md",
title: "Auth API Documentation"
}
]Epic: Task Management API
Tool: create_issue
Parent Issue:
title: "[EPIC][Backend] Task Management API"
team: "Backend"
description: |
## API Endpoints
### Tasks
- GET /api/tasks
- POST /api/tasks
- GET /api/tasks/:id
- PUT /api/tasks/:id
- DELETE /api/tasks/:id
- PATCH /api/tasks/:id/status
### Projects
- GET /api/projects
- POST /api/projects
- GET /api/projects/:id
- PUT /api/projects/:id
- DELETE /api/projects/:id
### Comments
- GET /api/tasks/:id/comments
- POST /api/tasks/:id/comments
- DELETE /api/comments/:id
## Features
- Filtering and sorting
- Pagination
- Search functionality
- Bulk operations
- File uploads
## Documentation
- Full OpenAPI spec
- Request/response examples
- Error codes documented
project: "Task Management API + Web App"
labels: ["epic", "backend", "api"]
priority: 1Phase 2: Frontend Integration
Parallel Frontend Work
While backend is being developed, create frontend issues:
Tool: create_issue
Issue: API Client Setup
title: "[Frontend] Setup API client with authentication"
team: "Frontend"
description: |
## Tasks
- [ ] Create Axios instance with base configuration
- [ ] Implement request interceptor for auth token
- [ ] Implement response interceptor for token refresh
- [ ] Handle 401 responses (redirect to login)
- [ ] Setup environment variables for API URL
- [ ] Create TypeScript types for API responses
## API Client Structure// api/client.ts import axios from 'axios';
const apiClient = axios.create({ baseURL: process.env.REACT_APP_API_URL, timeout: 10000, });
// Request interceptor apiClient.interceptors.request.use( (config) => { const token = localStorage.getItem('accessToken'); if (token) { config.headers.Authorization = Bearer ${token}; } return config; } );
// Response interceptor apiClient.interceptors.response.use( (response) => response, async (error) => { // Handle token refresh if (error.response?.status === 401) { // Refresh token logic } return Promise.reject(error); } );
export default apiClient;
## Acceptance Criteria
- API client configured
- Auth token handling works
- Token refresh implemented
- TypeScript types defined
- Error handling robust
assignee: "frontend-dev-1"
project: "Task Management API + Web App"
labels: ["frontend", "api-integration"]
priority: 1Issue: Auth Integration
title: "[Frontend] Authentication flow integration"
team: "Frontend"
description: |
## Tasks
- [ ] Create auth context/provider
- [ ] Implement login form
- [ ] Implement registration form
- [ ] Implement logout functionality
- [ ] Implement forgot password flow
- [ ] Setup protected routes
- [ ] Handle auth state persistence
## Components to Create
- LoginPage
- RegisterPage
- ForgotPasswordPage
- ResetPasswordPage
- AuthProvider
## State Managementinterface AuthState { user: User | null; isAuthenticated: boolean; isLoading: boolean; login: (email: string, password: string) => Promise<void>; register: (data: RegisterData) => Promise<void>; logout: () => void; }
## Acceptance Criteria
- Login works with backend
- Registration works with backend
- Logout clears tokens
- Protected routes redirect
- Auth state persists on reload
assignee: "frontend-dev-1"
project: "Task Management API + Web App"
labels: ["frontend", "auth", "integration"]
priority: 1Coordination Between Teams
Tracking Integration Points
Tool: create_issue
Coordination Issue:
title: "[Integration] Task API ↔️ Frontend Task Management"
team: "Full-Stack"
description: |
## Backend Status
- [x] Database schema complete
- [x] CRUD endpoints implemented
- [ ] Filtering/sorting endpoints
- [ ] File upload endpoint
- [ ] WebSocket events
## Frontend Status
- [x] API client setup
- [x] Task components created
- [ ] List view implementation
- [ ] Create/Edit forms
- [ ] File upload UI
## Integration Checklist
- [ ] API types synced with frontend
- [ ] Error handling coordinated
- [ ] Loading states consistent
- [ ] Validation rules match
- [ ] E2E tests passing
## Blockers
- ⚠️ Frontend blocked on file upload endpoint
- Estimated backend completion: Tomorrow
## Communication
- Daily sync meeting: 10 AM
- Slack channel: #api-integration
- API docs: [link]
assignee: "tech-lead"
project: "Task Management API + Web App"
labels: ["integration", "coordination", "backend", "frontend"]
priority: 2API Documentation Workflow
Creating API Documentation Issue
Tool: create_issue
Issue:
title: "[Backend] Complete OpenAPI documentation"
team: "Backend"
description: |
## Documentation Requirements
### OpenAPI Spec
- [ ] All endpoints documented
- [ ] Request schemas defined
- [ ] Response schemas defined
- [ ] Error responses documented
- [ ] Authentication documented
- [ ] Examples for all endpoints
### Additional Documentation
- [ ] Postman collection updated
- [ ] README with quickstart
- [ ] Authentication guide
- [ ] Error handling guide
- [ ] Rate limiting docs
## Tools
- Swagger UI hosted at /api-docs
- Postman collection exported
- TypeScript types generated from OpenAPI
## Acceptance Criteria
- OpenAPI spec complete and valid
- Swagger UI accessible
- Postman collection works
- Frontend team approved docs
assignee: "backend-dev-2"
project: "Task Management API + Web App"
labels: ["backend", "documentation", "api"]
priority: 2Testing Workflow
Backend Testing
Tool: create_issue
Issue:
title: "[Backend] API integration tests"
team: "Backend"
description: |
## Test Coverage Requirements
### Unit Tests (80% coverage)
- [ ] Auth service tests
- [ ] Task service tests
- [ ] User service tests
- [ ] Validation tests
- [ ] Utility function tests
### Integration Tests
- [ ] Auth endpoints (register, login, logout, refresh)
- [ ] Task CRUD operations
- [ ] Project CRUD operations
- [ ] Comment operations
- [ ] File upload/download
- [ ] Authorization checks
### E2E Tests
- [ ] Complete user workflows
- [ ] Error scenarios
- [ ] Rate limiting
- [ ] Concurrent requests
## Test Framework
- Jest for unit tests
- Supertest for API tests
- Test database setup/teardown
## Acceptance Criteria
- All tests passing
- 80%+ code coverage
- CI pipeline green
- Performance tests included
assignee: "backend-dev-1"
project: "Task Management API + Web App"
labels: ["backend", "testing"]
priority: 2Frontend Testing
Tool: create_issue
Issue:
title: "[Frontend] Component and integration tests"
team: "Frontend"
description: |
## Test Coverage
### Unit Tests (70% coverage)
- [ ] Component tests (React Testing Library)
- [ ] Hook tests
- [ ] Utility function tests
- [ ] API client tests (mocked)
### Integration Tests
- [ ] Auth flow tests (with mocked API)
- [ ] Task management flow
- [ ] Form validation
- [ ] Error handling
### E2E Tests (Cypress)
- [ ] Login/Register flow
- [ ] Create/Edit task flow
- [ ] Project management
- [ ] File upload
- [ ] Responsive design
## Test Framework
- Jest + React Testing Library
- Cypress for E2E
- MSW for API mocking
## Acceptance Criteria
- All tests passing
- 70%+ component coverage
- E2E tests cover critical paths
- CI integration complete
assignee: "frontend-dev-2"
project: "Task Management API + Web App"
labels: ["frontend", "testing"]
priority: 2Deployment Workflow
Creating Deployment Issues
Tool: create_issue
Issue:
title: "[DevOps] Docker containerization and AWS deployment"
team: "DevOps"
description: |
## Containerization
### Backend Dockerfile
- [ ] Multi-stage build for optimization
- [ ] Production dependencies only
- [ ] Health check endpoint
- [ ] Non-root user
### Frontend Dockerfile
- [ ] Nginx for serving static files
- [ ] GZIP compression
- [ ] Cache headers
- [ ] Security headers
### Docker Compose
- [ ] Development environment
- [ ] Backend + Frontend + Database
- [ ] Volume mounts for hot reload
- [ ] Environment variables
## AWS Deployment
### Infrastructure
- [ ] ECS cluster setup
- [ ] RDS PostgreSQL instance
- [ ] Application Load Balancer
- [ ] CloudFront CDN for frontend
- [ ] S3 bucket for file uploads
- [ ] Route53 DNS configuration
### CI/CD Pipeline
- [ ] GitHub Actions workflow
- [ ] Automated testing
- [ ] Docker image builds
- [ ] ECS deployment
- [ ] Rollback strategy
## Acceptance Criteria
- App deploys successfully
- Zero-downtime deployments
- Health checks working
- Monitoring in place
- Backup strategy implemented
assignee: "devops-engineer"
project: "Task Management API + Web App"
labels: ["devops", "deployment", "infrastructure"]
priority: 1Daily Coordination Queries
Backend Team View
Tool: list_issues
Parameters:
team: "Backend"
project: "Task Management API + Web App"
state: "In Progress"
orderBy: "updatedAt"Frontend Team View
Tool: list_issues
Parameters:
team: "Frontend"
project: "Task Management API + Web App"
state: "In Progress"
orderBy: "updatedAt"Integration Blockers
Tool: list_issues
Parameters:
project: "Task Management API + Web App"
label: "blocked"
state: "In Progress"
orderBy: "priority"Ready for Integration
Tool: list_issues
Parameters:
project: "Task Management API + Web App"
label: "ready-for-integration"
orderBy: "updatedAt"Progress Tracking
Weekly Sprint Review
Tool: list_issues
Backend Completed:
team: "Backend"
project: "Task Management API + Web App"
state: "Done"
orderBy: "updatedAt"
limit: 20
Frontend Completed:
team: "Frontend"
project: "Task Management API + Web App"
state: "Done"
orderBy: "updatedAt"
limit: 20Best Practices for Full-Stack Projects
1. API-First Development:
- Define API contracts first
- Frontend can mock APIs while backend builds
- Use OpenAPI for contract
2. Parallel Development:
- Backend and frontend teams work simultaneously
- Use integration issues to track dependencies
- Regular sync meetings
3. Clear Communication:
- Tag relevant team members in comments
- Update issue status promptly
- Document blockers clearly
4. Type Safety:
- Generate TypeScript types from OpenAPI
- Share types between backend and frontend
- Validate at runtime
5. Testing Strategy:
- Backend: Unit + Integration tests
- Frontend: Component + E2E tests
- Full-stack: Integration E2E tests
6. Deployment Coordination:
- Deploy backend first
- Test with production API
- Deploy frontend
- Monitor both services
This workflow ensures efficient, organized full-stack development with clear coordination between teams.
Mobile App Development Workflow
Complete workflow for managing a Flutter/React Native mobile app project in Linear.
Project: Chat Application (iOS + Android)
Initial Project Setup
Tool: create_project
Parameters:
name: "Chatz - Mobile Chat App"
team: "Mobile"
summary: "WhatsApp-inspired chat app with voice/video calls and microtransaction system"
description: |
# Chatz Mobile App
## Overview
A modern chat application for iOS and Android with the following features:
- Real-time messaging
- Voice and video calls (pay-per-minute with Agora)
- International phone authentication
- Group chats
- Media sharing (photos, videos, documents)
- End-to-end encryption
## Tech Stack
- Flutter for cross-platform development
- Firebase for authentication and real-time database
- Agora SDK for voice/video calls
- Stripe for payment processing
- Firebase Cloud Messaging for push notifications
## Platforms
- iOS 14+ (iPhone, iPad)
- Android 8.0+ (phones and tablets)
## Development Phases
1. **Phase 1**: Core messaging (Weeks 1-4)
2. **Phase 2**: Voice/Video calls (Weeks 5-7)
3. **Phase 3**: Payment integration (Weeks 8-9)
4. **Phase 4**: Polish & Testing (Weeks 10-12)
## Success Criteria
- App Store and Play Store submission ready
- < 100ms message latency
- 99.9% call connection success rate
- Payment success rate > 95%
- 5-star rating average in beta testing
lead: "me"
priority: 1
startDate: "2025-01-15"
targetDate: "2025-04-15"
labels: ["mobile", "flutter", "ios", "android"]Phase 1: Core Messaging Features
Epic: Authentication System
Tool: create_issue
Parent Issue:
title: "[EPIC] Phone Authentication & User Management"
team: "Mobile"
description: |
## Features
- Phone number entry with country code picker
- SMS OTP verification
- User profile creation
- Profile photo upload
- Contact sync and permissions
## Design
Figma: [link]
## Platform Considerations
- iOS: Handle App Store review requirements
- Android: Handle SMS permissions properly
project: "Chatz - Mobile Chat App"
labels: ["epic", "auth", "mobile"]
priority: 1Child Issues for Authentication
Issue 1: Phone Input Screen
title: "[iOS/Android] Phone number input screen"
team: "Mobile"
description: |
## Tasks
- [ ] Create PhoneInputScreen widget
- [ ] Implement country code picker
- [ ] Add phone number formatting
- [ ] Input validation
- [ ] Handle iOS keyboard properly
- [ ] Test on various Android devices
## Platform-Specific
- iOS: Match iOS design guidelines
- Android: Material Design compliance
## Acceptance Criteria
- Works on iOS 14+
- Works on Android 8.0+
- Proper keyboard handling on both platforms
- Accessibility labels
parentId: "[auth-epic-id]"
assignee: "mobile-dev-1"
project: "Chatz - Mobile Chat App"
labels: ["mobile", "flutter", "ui", "ios", "android"]
priority: 1Issue 2: SMS OTP Verification
title: "[Backend + Mobile] SMS verification implementation"
team: "Mobile"
description: |
## Tasks
- [ ] Integrate Firebase Auth
- [ ] Implement SMS sending
- [ ] Create OTP input screen
- [ ] Auto-read SMS on Android
- [ ] Manual entry on iOS
- [ ] Handle verification errors
- [ ] Implement retry logic
## Platform Testing
- Test on real iOS devices
- Test on real Android devices
- Test with different carriers
- Test in different regions
## Acceptance Criteria
- OTP arrives within 10 seconds
- Auto-read works on Android
- Clear error messages
- Resend OTP functionality
parentId: "[auth-epic-id]"
assignee: "mobile-dev-1"
project: "Chatz - Mobile Chat App"
labels: ["mobile", "flutter", "auth", "backend"]
priority: 1
links: [
{
url: "https://firebase.google.com/docs/auth/flutter/phone-auth",
title: "Firebase Phone Auth Documentation"
}
]Epic: Real-Time Messaging
Tool: create_issue
Parent Issue:
title: "[EPIC] Real-Time Messaging System"
team: "Mobile"
description: |
## Features
- One-on-one chat
- Real-time message sync
- Message status (sent, delivered, read)
- Typing indicators
- Message reactions
- Reply to messages
- Forward messages
## Technical Requirements
- Firebase Realtime Database for messages
- Local caching with sqflite
- Optimistic UI updates
- Background sync
## Acceptance Criteria
- Messages appear instantly
- Works offline with queue
- Battery efficient
- Handles 1000+ messages per chat
project: "Chatz - Mobile Chat App"
labels: ["epic", "messaging", "mobile"]
priority: 1Child Issues for Messaging
Issue 1: Chat List Screen
title: "[iOS/Android] Chat list screen with real-time updates"
team: "Mobile"
description: |
## Tasks
- [ ] Create ChatListScreen widget
- [ ] Implement chat list tile
- [ ] Real-time updates from Firebase
- [ ] Unread message badges
- [ ] Last message preview
- [ ] Swipe actions (iOS style, Android style)
- [ ] Pull to refresh
- [ ] Empty state design
## Performance
- Lazy loading for 100+ chats
- Efficient list rebuilding
- Image caching
## Platform Differences
- iOS: Swipe to delete/archive
- Android: Long press context menu
## Acceptance Criteria
- Smooth scrolling with 500+ chats
- Real-time updates without lag
- Proper platform conventions
parentId: "[messaging-epic-id]"
assignee: "mobile-dev-2"
project: "Chatz - Mobile Chat App"
labels: ["mobile", "flutter", "ui", "ios", "android"]
priority: 1Issue 2: Chat Screen Implementation
title: "[iOS/Android] Individual chat screen"
team: "Mobile"
description: |
## Tasks
- [ ] Create ChatScreen widget
- [ ] Message bubbles (sent/received)
- [ ] Timestamp display
- [ ] Message status indicators
- [ ] Input field with attachment button
- [ ] Emoji keyboard
- [ ] Scroll to bottom behavior
- [ ] Load more messages on scroll up
## Message Features
- [ ] Copy message
- [ ] Reply to message
- [ ] Forward message
- [ ] Delete message
- [ ] React to message
## Platform-Specific
- iOS: Native keyboard handling
- Android: Custom keyboard toolbar
## Acceptance Criteria
- Handles 10,000+ messages smoothly
- Optimistic updates work correctly
- Proper keyboard behavior
- Works in landscape mode
parentId: "[messaging-epic-id]"
assignee: "mobile-dev-2"
project: "Chatz - Mobile Chat App"
labels: ["mobile", "flutter", "messaging", "ui"]
priority: 1Phase 2: Voice/Video Calls
Platform-Specific Issues
Issue: iOS Call Integration
title: "[iOS] CallKit integration for native call experience"
team: "Mobile"
description: |
## Overview
Integrate CallKit for native iOS calling experience
## Tasks
- [ ] Setup CallKit provider
- [ ] Handle incoming call UI
- [ ] Lock screen call interface
- [ ] Call history in iOS phone app
- [ ] Handle interruptions
- [ ] Background call handling
## Apple Requirements
- [ ] VoIP push notifications
- [ ] Proper Info.plist permissions
- [ ] App Store review compliance
## Testing
- Test on various iOS versions (14, 15, 16, 17)
- Test with AirPods, Bluetooth
- Test during other calls
- Test with Do Not Disturb
## Acceptance Criteria
- Native iOS call experience
- Works with locked screen
- Proper audio routing
- App Store compliant
assignee: "ios-specialist"
project: "Chatz - Mobile Chat App"
labels: ["mobile", "ios", "calls", "platform-specific"]
priority: 1Issue: Android Call Integration
title: "[Android] ConnectionService integration for native calls"
team: "Mobile"
description: |
## Overview
Integrate ConnectionService for native Android calling
## Tasks
- [ ] Implement ConnectionService
- [ ] Full-screen incoming call UI
- [ ] Lock screen call interface
- [ ] Call logs integration
- [ ] Handle Bluetooth audio
- [ ] Background call handling
## Android-Specific
- [ ] Request proper permissions
- [ ] Handle battery optimization
- [ ] Foreground service for active calls
## Testing
- Test on different Android versions (8-14)
- Test on various manufacturers (Samsung, Pixel, OnePlus)
- Test with Bluetooth devices
- Test battery drain
## Acceptance Criteria
- Native Android call experience
- Works with locked screen
- Appears in call logs
- Battery efficient
assignee: "android-specialist"
project: "Chatz - Mobile Chat App"
labels: ["mobile", "android", "calls", "platform-specific"]
priority: 1Bug Tracking Workflow
Creating a Bug Report
Tool: create_issue
Bug Example:
title: "[BUG][iOS] Messages not syncing in background"
team: "Mobile"
description: |
## Bug Description
Messages received while app is in background don't appear until app is opened
## Environment
- Platform: iOS
- iOS Version: 16.5
- Device: iPhone 14 Pro
- App Version: 0.8.2 (build 45)
## Steps to Reproduce
1. Open app and log in
2. Have active chat conversation
3. Put app in background (home button)
4. Have someone send you messages
5. Wait 30 seconds
6. Open app again
7. Messages appear only after opening
## Expected Behavior
- Background fetch should sync new messages
- Push notification should trigger sync
- Messages should be ready when app opens
## Actual Behavior
- Messages only sync when app opens
- 2-5 second delay before messages appear
- Push notification arrives but no data sync
## Additional Context
- Works correctly on Android
- Background fetch is enabled in settings
- Push notifications work for other events
## Screenshots
[Attach screenshots]
## Logs[Paste relevant logs]
labels: ["bug", "ios", "messaging", "background-sync"]
priority: 1
assignee: "ios-specialist"
project: "Chatz - Mobile Chat App"Testing and QA Workflow
Creating Test Issues
Tool: create_issue
Test Plan Issue:
title: "[QA] iOS App Store submission testing checklist"
team: "Mobile"
description: |
## Pre-Submission Testing
### Functionality
- [ ] All features work on iOS 14, 15, 16, 17
- [ ] Tested on iPhone SE, 13, 14, 15
- [ ] Tested on iPad
- [ ] Landscape mode works
- [ ] Dark mode works correctly
- [ ] All localizations tested
### Permissions
- [ ] Camera permission flow
- [ ] Microphone permission flow
- [ ] Photo library permission
- [ ] Contacts permission
- [ ] Notifications permission
- [ ] All permission messages clear
### App Store Requirements
- [ ] Privacy policy linked
- [ ] Terms of service linked
- [ ] Support URL working
- [ ] Account deletion flow
- [ ] App Store screenshots prepared
- [ ] App preview video created
### Performance
- [ ] App size < 50MB
- [ ] Launch time < 2 seconds
- [ ] No memory leaks
- [ ] Battery drain acceptable
### Edge Cases
- [ ] Poor network handling
- [ ] Offline mode works
- [ ] Background refresh works
- [ ] Push notifications work
- [ ] Deep linking works
## Review Checklist
- [ ] Metadata prepared
- [ ] Build uploaded to TestFlight
- [ ] Internal testing complete
- [ ] External beta testing complete
- [ ] All blocking bugs fixed
## Assigned Testers
- iOS Tester 1: Functionality
- iOS Tester 2: Performance
- QA Lead: Final review
labels: ["qa", "testing", "ios", "app-store"]
priority: 1
project: "Chatz - Mobile Chat App"Release Management
Creating Release Issues
Tool: create_issue
Release Issue:
title: "[RELEASE] iOS v1.0.0 App Store Submission"
team: "Mobile"
description: |
## Release Information
- Version: 1.0.0
- Build: 100
- Target Date: March 15, 2025
- Platform: iOS
## Pre-Release Checklist
- [ ] All features complete
- [ ] All bugs fixed
- [ ] QA testing passed
- [ ] Performance benchmarks met
- [ ] Privacy policy updated
- [ ] App Store assets ready
## Submission Checklist
- [ ] Build uploaded to App Store Connect
- [ ] TestFlight testing complete
- [ ] App Store metadata complete
- [ ] Screenshots uploaded (all sizes)
- [ ] Privacy nutrition labels filled
- [ ] Age rating set
- [ ] Support URL working
- [ ] Submit for review
## Post-Submission
- [ ] Monitor review status
- [ ] Respond to review feedback
- [ ] Release after approval
- [ ] Monitor crash reports
- [ ] Monitor user reviews
## Rollback Plan
- Previous version: 0.9.5 (build 95)
- Rollback procedure: [link to docs]
## Links
- App Store Connect: [link]
- TestFlight: [link]
- Release notes: [link]
labels: ["release", "ios", "app-store"]
priority: 1
assignee: "release-manager"
project: "Chatz - Mobile Chat App"
dueDate: "2025-03-15"Daily Workflow Queries
My Tasks for Today
Tool: list_issues
Parameters:
assignee: "me"
state: "In Progress"
project: "Chatz - Mobile Chat App"
orderBy: "updatedAt"
limit: 5Platform-Specific Issues
Tool: list_issues
iOS Issues:
label: "ios"
state: "Todo"
project: "Chatz - Mobile Chat App"
Android Issues:
label: "android"
state: "Todo"
project: "Chatz - Mobile Chat App"
Cross-Platform Issues:
label: "shared"
state: "In Progress"
project: "Chatz - Mobile Chat App"Bugs by Priority
Tool: list_issues
Critical Bugs:
label: "bug"
priority: 1
state: "Todo"
project: "Chatz - Mobile Chat App"
Platform-Specific Bugs:
label: "bug"
label: "ios" # or "android"
orderBy: "createdAt"Project Status Updates
Weekly Update
Tool: update_project
Parameters:
id: "[project-id]"
description: |
# Chatz Mobile App
## Status: Week 8 of 12 - On Track ✅
## Progress This Week
- ✅ Voice calls implementation complete
- ✅ iOS CallKit integration done
- ✅ Android ConnectionService working
- 🔄 Payment integration in progress
## Platform Status
### iOS
- Features: 85% complete
- Bugs: 3 open (0 critical)
- TestFlight: v0.9.2 available
- App Store: Preparing for submission
### Android
- Features: 82% complete
- Bugs: 5 open (1 high priority)
- Internal testing: v0.9.1
- Play Store: Beta track ready
## Metrics
- Total Issues: 78
- Completed: 58 (74%)
- In Progress: 12 (15%)
- Todo: 8 (10%)
## Next Week
- Complete payment integration
- Fix remaining high-priority bugs
- Start App Store submission prep
- Begin Play Store beta testing
## Risks
- ⚠️ App Store review timing uncertain
- Mitigation: Submit early, plan buffer
[Previous content...]Tips for Mobile Development
1. Label Platform-Specific Issues:
- Use "ios", "android", "shared" labels
- Filter easily by platform
2. Track Device-Specific Bugs:
- Include device info in bug titles
- Example: "[BUG][Samsung S21] Camera crash"
3. Separate Release Tracks:
- iOS and Android have different timelines
- Create separate release issues
4. Test Across Devices:
- Document device testing in comments
- Track which devices have been tested
5. Version Tracking:
- Link issues to version milestones
- Track features per release
6. App Store/Play Store Requirements:
- Create comprehensive checklists
- Update as requirements change
7. Performance Metrics:
- Include performance criteria in acceptance
- Document benchmark results
This workflow ensures organized, efficient mobile app development with clear platform-specific tracking.
Linear Development Accelerator - Installation Guide
Quick Start
The Linear Development Accelerator skill is ready to use with Claude Code or Claude API.
Installation for Claude Code
Option 1: Direct Copy (Recommended)
1. Locate your Claude Code skills directory:
- macOS:
~/Library/Application Support/Claude/skills/ - Linux:
~/.config/Claude/skills/ - Windows:
%APPDATA%\Claude\skills\
2. Copy the linear-dev-accelerator folder to the skills directory:
cp -r /Users/manu/Documents/LUXOR/linear-dev-accelerator ~/Library/Application\ Support/Claude/skills/3. Restart Claude Code (if running)
4. The skill will activate automatically when you discuss:
- Linear project management
- Software development workflows
- Issue tracking and sprint planning
- Project setup for web or mobile apps
Option 2: Symlink (For Development)
If you want to continue editing the skill:
ln -s /Users/manu/Documents/LUXOR/linear-dev-accelerator ~/Library/Application\ Support/Claude/skills/linear-dev-acceleratorVerification
Test that the skill is installed correctly:
1. Open Claude Code 2. Type: "Help me set up a new React project in Linear" 3. Claude should reference the Linear Development Accelerator skill
Prerequisites
Linear MCP Server
This skill requires the Linear MCP server to be configured:
1. Install Linear MCP Server:
npm install -g @linear/mcp-server2. Configure in Claude Code: Add to your MCP server configuration:
{
"linear": {
"command": "npx",
"args": ["-y", "@linear/mcp-server"],
"env": {
"LINEAR_API_KEY": "your-linear-api-key"
}
}
}3. Get Linear API Key:
- Go to Linear Settings → API
- Create new Personal API Key
- Copy and add to configuration
Skill Structure
linear-dev-accelerator/
├── SKILL.md # Core skill knowledge base
├── README.md # Documentation
├── INSTALLATION.md # This file
└── examples/
├── frontend-project-setup.md # React/frontend workflows
├── mobile-app-workflow.md # iOS/Android workflows
└── full-stack-api-development.md # Full-stack workflowsUsing the Skill
Activation
The skill activates automatically when you:
- Mention "Linear" in context of project management
- Ask about setting up development projects
- Request help with issue tracking or sprint planning
- Discuss software development workflows
Example Prompts
Frontend Project:
"I'm starting a new e-commerce frontend in React.
Set it up in Linear with proper project structure."Mobile App:
"Help me organize a Flutter chat app project in Linear
with separate tracking for iOS and Android."Full-Stack Project:
"Set up Linear project management for a Node.js API
with React frontend, including coordination between teams."Issue Management:
"Create a bug report template in Linear for our team"Sprint Planning:
"Help me plan the next 2-week sprint for my frontend team"Customization
Editing the Skill
1. Edit SKILL.md to customize:
- Label taxonomies
- Workflow patterns
- Issue templates
- Best practices
2. Add new examples in examples/ directory
3. Update README.md with your customizations
Team-Specific Adaptations
Create team-specific versions:
cp -r linear-dev-accelerator linear-dev-accelerator-frontend
# Edit linear-dev-accelerator-frontend/SKILL.md for frontend-specific patterns
cp -r linear-dev-accelerator linear-dev-accelerator-mobile
# Edit linear-dev-accelerator-mobile/SKILL.md for mobile-specific patternsTroubleshooting
Skill Not Activating
1. Check skill location: Ensure folder is in correct skills directory 2. Restart Claude Code: Close and reopen application 3. Check SKILL.md format: Verify YAML frontmatter is correct 4. Use explicit activation: Mention "using the Linear Development Accelerator skill"
MCP Server Issues
1. Verify installation:
npx @linear/mcp-server --version2. Check API key: Ensure LINEAR_API_KEY is set correctly
3. Test connection: Try a simple Linear operation:
"List my Linear teams"4. Review logs: Check Claude Code logs for MCP connection errors
Skill Updates
To update the skill with improvements:
1. Pull latest changes 2. Copy updated files to skills directory 3. Restart Claude Code
Tips for Maximum Effectiveness
1. Use Specific Prompts: Reference project type (frontend, mobile, full-stack) 2. Provide Context: Mention tech stack (React, Flutter, Node.js) 3. Reference Examples: "Use the mobile app workflow from the skill" 4. Combine with /deep: For research-heavy tasks, combine skill with /deep command 5. Leverage Templates: Ask Claude to use templates from the skill
Support
For issues or questions:
- Review the examples in
examples/directory - Check
SKILL.mdfor comprehensive reference - Consult Linear documentation: https://linear.app/docs
- Check Linear MCP server docs: https://github.com/linear/linear-mcp
What's Next
After installation:
1. Explore Examples: Read through the three example workflows 2. Test on Real Project: Use skill to set up an actual project 3. Customize for Your Team: Adapt templates and patterns 4. Share with Team: Document team-specific conventions 5. Iterate and Improve: Refine based on real-world usage
Version Information
- Skill Version: 1.0.0
- Release Date: October 2025
- Compatible With: Claude Code, Claude API with MCP support
- Linear MCP Server: All versions
License
This skill is provided as-is for use with Claude applications.
---
Ready to accelerate? Start using the Linear Development Accelerator skill today!
Linear Workflow Guide
Complete guide to using Linear for accelerated software development with the Linear Development Accelerator skill.
Table of Contents
1. Linear Fundamentals 2. Project Setup Workflows 3. Daily Development Workflows 4. Team Collaboration Patterns 5. Sprint/Cycle Management 6. GitHub Integration 7. Advanced Workflows 8. Best Practices
Linear Fundamentals
Core Entities
Understanding Linear's hierarchy:
Workspace (Organization)
├── Teams (e.g., Frontend, Backend, Mobile)
│ ├── Projects (Major initiatives)
│ │ └── Issues (Individual tasks)
│ ├── Cycles (Sprints/iterations)
│ │ └── Issues
│ └── Labels (Categorization)
└── Users (Team members)Issue Lifecycle
Backlog → Todo → In Progress → In Review → Done
→ CanceledKey Concepts
Issues: The fundamental unit of work
- Can be standalone or part of a project
- Can have parent/child relationships
- Track with labels, status, priority, assignee
Projects: Collections of related issues for larger initiatives
- Have start/target dates
- Track progress across multiple issues
- Can span multiple cycles
Cycles: Time-boxed iterations (like sprints)
- Typically 1-2 weeks
- Help organize work into manageable chunks
- Track team velocity
Labels: Flexible categorization system
- Type labels (bug, feature, improvement)
- Area labels (frontend, backend, mobile)
- Status labels (blocked, ready-for-dev)
- Technology labels (react, python, flutter)
Project Setup Workflows
1. New Frontend Project
Scenario: Starting a React e-commerce frontend
Step 1: Create the project
─────────────────────────────
Use: create_project
name: "E-Commerce Frontend Redesign"
team: "Frontend"
summary: "Modern e-commerce UI with React + TypeScript"
description: |
# Project Overview
Complete redesign of e-commerce platform
## Tech Stack
- React 18 + TypeScript
- Tailwind CSS
- Zustand state management
- Vite build tool
## Goals
- Modern UI/UX
- < 2s load time
- Mobile responsive
- Accessibility compliant
## Timeline
Q1 2025: Design & Setup (2 weeks)
Q2 2025: Core Features (6 weeks)
Q3 2025: Testing & Launch (4 weeks)
lead: "me"
priority: 2 (High)
startDate: "2025-01-15"
targetDate: "2025-04-15"
labels: ["frontend", "react", "redesign"]Step 2: Create epic issues
─────────────────────────────
Epic 1: Design System
Use: create_issue
title: "[EPIC] Design System & Component Library"
team: "Frontend"
description: |
## Overview
Build reusable design system
## Components
- Primitive components (Button, Input, Card)
- Color palette (light/dark modes)
- Typography system
- Spacing/sizing tokens
## Deliverables
- Storybook documentation
- Component library npm package
project: "E-Commerce Frontend Redesign"
labels: ["epic", "design-system"]
priority: 1
Epic 2: Product Catalog
Epic 3: Shopping Cart
Epic 4: Checkout FlowStep 3: Break down into tasks
─────────────────────────────
For each epic, create child issues:
Use: create_issue
title: "Create Button component with variants"
parentId: "[design-system-epic-id]"
team: "Frontend"
description: |
## Tasks
- [ ] Design variants (primary, secondary, ghost)
- [ ] Implement component
- [ ] Add loading state
- [ ] Add icon support
- [ ] Write unit tests
- [ ] Document in Storybook
## Acceptance Criteria
- All variants implemented
- Accessible (ARIA labels)
- Tests passing
- Documented
assignee: "frontend-dev-1"
labels: ["component", "design-system"]
priority: 22. New Mobile App Project
Scenario: Flutter chat application (iOS + Android)
Step 1: Create project with platform tracking
─────────────────────────────────────────────
Use: create_project
name: "Chat App - iOS & Android"
team: "Mobile"
summary: "Real-time chat app with voice/video calls"
description: |
# Chat Application
## Platforms
- iOS 14+ (iPhone, iPad)
- Android 8.0+ (phones, tablets)
## Features
- Real-time messaging
- Voice/video calls (Agora SDK)
- Group chats
- Media sharing
- Push notifications
## Platform Notes
- iOS: CallKit integration
- Android: ConnectionService
- Shared: 80% code reuse
labels: ["mobile", "flutter", "ios", "android"]Step 2: Create platform-specific issues
──────────────────────────────────────
Use: create_issue
# Shared functionality
title: "Implement real-time messaging"
team: "Mobile"
labels: ["shared", "messaging", "flutter"]
description: |
## Platform: Both iOS & Android
Core messaging implementation
...
# iOS-specific
title: "[iOS] CallKit integration for native calls"
team: "Mobile"
labels: ["ios", "calls", "platform-specific"]
description: |
## Platform: iOS Only
Integrate CallKit for native call experience
...
# Android-specific
title: "[Android] ConnectionService integration"
team: "Mobile"
labels: ["android", "calls", "platform-specific"]
description: |
## Platform: Android Only
Integrate ConnectionService
...3. New Full-Stack Project
Scenario: Node.js API + React Frontend
Step 1: Create main project
──────────────────────────
Use: create_project
name: "Task Management System - Full Stack"
team: "Full-Stack"
description: |
# Task Management System
## Architecture
- Backend: Node.js + Express + PostgreSQL
- Frontend: React + TypeScript + Tailwind
- API: RESTful with JWT auth
- Deployment: Docker + AWS
## Development Strategy
- API-first development
- Parallel frontend/backend work
- Comprehensive testing
## Team Coordination
- Backend team: 2 developers
- Frontend team: 2 developers
- Daily sync: 10 AMStep 2: Create backend and frontend epics
────────────────────────────────────────
Backend Epic:
title: "[EPIC][Backend] RESTful API Development"
team: "Backend"
labels: ["epic", "backend", "api"]
Frontend Epic:
title: "[EPIC][Frontend] Web Application UI"
team: "Frontend"
labels: ["epic", "frontend", "react"]Step 3: Create integration coordination issues
──────────────────────────────────────────────
Use: create_issue
title: "[Integration] Auth API ↔️ Frontend Auth Flow"
team: "Full-Stack"
description: |
## Coordination Point
Backend auth endpoints + Frontend login/register
## Backend Status
- [ ] POST /api/auth/register
- [ ] POST /api/auth/login
- [ ] POST /api/auth/refresh
## Frontend Status
- [ ] Login form component
- [ ] Register form component
- [ ] Auth context setup
## Dependencies
- Frontend blocked on: API endpoints complete
- Backend provides: OpenAPI spec
## Sync Points
- Daily standup: 10 AM
- API contract review: Wednesday
labels: ["integration", "coordination", "backend", "frontend"]
priority: 1Daily Development Workflows
Morning Routine
Check your active work:
Use: list_issues
assignee: "me"
state: "In Progress"
orderBy: "updatedAt"
limit: 10Review what's in your queue:
Use: list_issues
assignee: "me"
state: "Todo"
priority: [1, 2] # Urgent and High
orderBy: "priority"
limit: 10Starting Work on an Issue
1. Move issue to In Progress
────────────────────────────
Use: update_issue
id: "[issue-id]"
state: "In Progress"
assignee: "me"2. Create git branch using Linear's suggested name
──────────────────────────────────────────────────
Use: get_issue (to get gitBranchName)
id: "[issue-id]"
Returns: gitBranchName: "team/CET-123-feature-name"
$ git checkout -b team/CET-123-feature-name3. Add initial progress comment
───────────────────────────────
Use: create_comment
issueId: "[issue-id]"
body: |
## Starting Work
**Approach:**
- First implementing core functionality
- Then adding tests
- Finally updating documentation
**Estimated completion:** End of dayDuring Development
Update progress regularly:
Use: create_comment
issueId: "[issue-id]"
body: |
## Progress Update
### Completed
- ✅ Core functionality implemented
- ✅ Unit tests written (12 tests)
### In Progress
- 🔄 Integration tests
### Blockers
- None currently
### Next
- Complete integration tests
- Update documentation
- Request code reviewCompleting Work
1. Create pull request
─────────────────────
# In your commit messages, reference Linear issue
$ git commit -m "CET-123: Implement user authentication"
$ git push origin team/CET-123-feature-name
$ gh pr create --title "CET-123: User authentication" --body "..."
Linear automatically links the PR!2. Move to In Review
───────────────────
Use: update_issue
id: "[issue-id]"
state: "In Review"
links: [
{
url: "https://github.com/org/repo/pull/123",
title: "PR: User authentication"
}
]3. After merge, mark as Done
───────────────────────────
Use: update_issue
id: "[issue-id]"
state: "Done"4. Add completion summary
────────────────────────
Use: create_comment
issueId: "[issue-id]"
body: |
## Completion Summary ✅
**PR merged:** #123
**Deployed to:** staging.example.com
**Implementation:**
- JWT-based authentication
- Refresh token rotation
- Rate limiting
**Testing:**
- 15 unit tests added
- 5 integration tests
- Manual testing complete
**Documentation:**
- API docs updated
- README updatedTeam Collaboration Patterns
Daily Standup Query
What did I work on yesterday?
Use: list_issues
assignee: "me"
state: "Done"
updatedAt: "-P1D" # Last 24 hours
limit: 10What am I working on today?
Use: list_issues
assignee: "me"
state: "In Progress"
orderBy: "priority"What's blocking me?
Use: list_issues
assignee: "me"
label: "blocked"
state: "In Progress"Code Review Workflow
Finding issues ready for review:
Use: list_issues
team: "Frontend"
state: "In Review"
orderBy: "createdAt"
limit: 10Adding review feedback:
Use: create_comment
issueId: "[issue-id]"
body: |
## Code Review Feedback
### Strengths
- ✅ Clean component structure
- ✅ Good test coverage
### Suggestions
- Consider extracting hook for form logic
- Add loading skeleton component
- Update TypeScript types for better inference
### Questions
- Why did we choose Zustand over Context?
**Status:** Approved with minor suggestionsCross-Team Coordination
Finding integration points:
Use: list_issues
label: "integration"
state: ["Todo", "In Progress"]
orderBy: "priority"Backend team: What's ready for frontend?
Use: list_issues
team: "Backend"
label: "ready-for-integration"
state: "Done"
orderBy: "updatedAt"Frontend team: What needs backend support?
Use: list_issues
team: "Frontend"
label: "blocked"
label: "needs-backend"
state: "In Progress"Sprint/Cycle Management
Planning a New Cycle
Step 1: Review backlog
─────────────────────
Use: list_issues
team: "Frontend"
state: "Backlog"
priority: [1, 2] # High priority items
orderBy: "priority"
limit: 50Step 2: Get current cycle
────────────────────────
Use: list_cycles
teamId: "[team-id]"
type: "current"Step 3: Move selected issues to cycle
────────────────────────────────────
Use: update_issue
id: "[issue-id]"
cycle: "[cycle-id-or-name]"
state: "Todo"Step 4: Assign and balance workload
──────────────────────────────────
# Review team capacity
Use: list_issues
team: "Frontend"
cycle: "[current-cycle]"
assignee: "dev-1"
# Adjust assignments
Use: update_issue
id: "[issue-id]"
assignee: "dev-2"Mid-Cycle Check-in
Cycle progress:
Use: list_issues
team: "Frontend"
cycle: "[current-cycle]"
state: "Done"Burndown tracking:
# Total issues in cycle
Use: list_issues
team: "Frontend"
cycle: "[current-cycle]"
# Completed
state: "Done"
# In Progress
state: "In Progress"
# Not started
state: "Todo"At-risk items:
Use: list_issues
team: "Frontend"
cycle: "[current-cycle]"
state: ["Todo", "In Progress"]
priority: 1 # UrgentCycle Retrospective
Completed work:
Use: list_issues
team: "Frontend"
cycle: "[cycle-name]"
state: "Done"
orderBy: "updatedAt"
limit: 100Incomplete work (move to next cycle):
Use: list_issues
team: "Frontend"
cycle: "[cycle-name]"
state: ["Todo", "In Progress"]
# Move to next cycle
Use: update_issue
id: "[issue-id]"
cycle: "[next-cycle-id]"GitHub Integration
Branch Naming
Use Linear's suggested git branch names:
Use: get_issue
id: "[issue-id]"
Returns: gitBranchName: "cetiaiservices/cet-95-feature-name"
$ git checkout -b cetiaiservices/cet-95-feature-nameCommit Messages
Reference Linear issues in commits:
# Pattern: ISSUE-ID: Description
git commit -m "CET-95: Add user authentication"
git commit -m "CET-96: Fix login form validation"Pull Request Integration
Automatic PR linking:
- Create PR from Linear branch
- Linear automatically detects and links PR
- PR status updates Linear issue status
Manual PR linking:
Use: update_issue
id: "[issue-id]"
links: [
{
url: "https://github.com/org/repo/pull/123",
title: "PR: Feature implementation"
}
]Deployment Tracking
Add deployment link after deploy:
Use: create_comment
issueId: "[issue-id]"
body: |
## Deployed ✅
**Environment:** Production
**URL:** https://app.example.com
**Deployed at:** 2025-01-15 14:30 UTC
**Commit:** abc123def
**Verified:**
- ✅ Feature working as expected
- ✅ No errors in logs
- ✅ Performance within targetsAdvanced Workflows
Bug Triage Process
Step 1: Create bug with template
───────────────────────────────
Use: create_issue
title: "[BUG] Login fails with OAuth providers"
team: "Backend"
description: |
## Bug Description
OAuth login (Google, GitHub) returning 500 error
## Environment
- Browser: Chrome 120
- OS: macOS 14
- Version: 1.2.3
## Steps to Reproduce
1. Click "Login with Google"
2. Authorize in Google popup
3. Redirect back to app
4. 500 error appears
## Expected Behavior
User should be logged in
## Actual Behavior
500 Internal Server Error
## Logs[ERROR] OAuth callback failed: Invalid state parameter
## Screenshots
[Attach screenshots]
labels: ["bug", "needs-triage", "oauth"]
priority: 1 # High - blocking usersStep 2: Triage and assign
────────────────────────
Use: update_issue
id: "[bug-id]"
state: "Todo"
assignee: "backend-auth-expert"
priority: 1
labels: ["bug", "oauth", "p1-critical"]Step 3: Investigation
────────────────────
Use: create_comment
issueId: "[bug-id]"
body: |
## Investigation
**Root cause:** State parameter mismatch between
initiation and callback
**Affected:** Google and GitHub OAuth only
**Impact:** ~30% of login attempts
**Fix approach:** Update state validation logicStep 4: Fix and verify
─────────────────────
Use: update_issue
id: "[bug-id]"
state: "Done"
Use: create_comment
body: |
## Fixed ✅
**PR:** #456
**Fix:** Updated OAuth state validation
**Testing:** 100 test logins successful
**Deployed:** Production
**Verification:**
- ✅ Google OAuth working
- ✅ GitHub OAuth working
- ✅ Error rate: 0%Release Management
Create release tracking issue:
Use: create_issue
title: "[RELEASE] v2.0.0 - Major Feature Release"
team: "Engineering"
description: |
## Release Information
- Version: 2.0.0
- Target Date: March 15, 2025
- Type: Major release
## Features Included
- [ ] User dashboard redesign (CET-45)
- [ ] Real-time notifications (CET-67)
- [ ] Dark mode support (CET-78)
- [ ] Performance improvements (CET-89)
## Pre-Release Checklist
- [ ] All features complete
- [ ] QA testing passed
- [ ] Performance benchmarks met
- [ ] Documentation updated
- [ ] Migration scripts ready
- [ ] Rollback plan documented
## Deployment Plan
1. Deploy to staging (March 13)
2. Stakeholder review (March 14)
3. Deploy to production (March 15, 6 AM UTC)
4. Monitor for 24 hours
## Rollback Procedure
Previous version: v1.9.5
Rollback time: < 5 minutes
[Link to rollback docs]
labels: ["release", "v2.0.0"]
priority: 1
dueDate: "2025-03-15"Performance Tracking
Create performance issue:
Use: create_issue
title: "[Performance] Dashboard load time optimization"
team: "Frontend"
description: |
## Current Performance
- Load time: 4.2s
- First Contentful Paint: 2.1s
- Largest Contentful Paint: 3.8s
## Targets
- Load time: < 2s (50% improvement)
- FCP: < 1s
- LCP: < 2s
## Optimization Tasks
- [ ] Code splitting by route
- [ ] Image lazy loading
- [ ] Bundle size reduction
- [ ] Server-side rendering
- [ ] Cache optimization
## Metrics Tracking
Will update with benchmark results
labels: ["performance", "optimization"]
priority: 2Update with results:
Use: create_comment
issueId: "[perf-issue-id]"
body: |
## Performance Results 📊
### Before
- Load time: 4.2s
- FCP: 2.1s
- LCP: 3.8s
- Bundle: 850 KB
### After
- Load time: 1.8s ✅ (57% improvement)
- FCP: 0.9s ✅
- LCP: 1.7s ✅
- Bundle: 420 KB ✅ (51% reduction)
### Optimizations Applied
- Code splitting: -200 KB
- Image optimization: -150 KB
- Tree shaking: -80 KB
**All targets met!**Best Practices
Issue Creation
Good Issue Title:
✅ "Add user profile edit functionality"
✅ "[Bug] Login form validation fails on mobile"
✅ "[Frontend] Implement dark mode toggle"
❌ "Fix bug"
❌ "Update stuff"
❌ "Make it work"Good Issue Description:
## Overview
Clear explanation of what and why
## Tasks
- [ ] Specific, actionable task 1
- [ ] Specific, actionable task 2
## Acceptance Criteria
- Clear definition of "done"
- Measurable outcomes
- Edge cases considered
## Resources
- Link to designs
- Link to documentation
- Related issuesLabel Strategy
Recommended taxonomy:
Type:
- feature
- bug
- improvement
- docs
- refactor
- test
Priority:
- p0-critical
- p1-high
- p2-medium
- p3-low
Area:
- frontend
- backend
- mobile
- devops
- design
Status:
- blocked
- ready-for-dev
- needs-review
- waiting-on-qa
Technology:
- react
- typescript
- python
- flutter
- postgresComment Guidelines
Effective comments:
✅ Provide context and decisions
✅ Document blockers and solutions
✅ Update stakeholders on progress
✅ Link to relevant resources
✅ Use formatting for clarity
❌ "Working on it"
❌ "Done"
❌ Duplicate information from commitsProject Updates
Weekly project update template:
Use: update_project
description: |
# [Project Name]
## Status: [On Track / At Risk / Blocked]
**Week X of Y**
## This Week
- ✅ Completed item 1
- ✅ Completed item 2
- 🔄 In progress item 3
## Next Week
- Planned item 1
- Planned item 2
## Metrics
- Issues completed: X/Y (Z%)
- On schedule: Yes/No
## Risks
- Risk 1: Description and mitigation
[Original project description preserved below]This comprehensive guide covers the essential Linear workflows for accelerated software development. Use it as a reference for setting up projects, managing daily work, coordinating teams, and maintaining best practices.
Linear Development Accelerator Skill
A comprehensive Claude skill for accelerating software development using Linear project management with MCP server integration.
Overview
This skill transforms Claude into a Linear project management expert, enabling rapid setup and management of software development projects across frontend, full-stack, and mobile applications. Built from extensive research of Linear's MCP server API and development best practices, this skill provides battle-tested workflows and automation patterns.
What This Skill Does
The Linear Development Accelerator skill teaches Claude to:
- Set up projects rapidly: Complete project structures with proper organization, labels, and workflows
- Manage issues intelligently: Create, update, and track issues with best-practice templates and workflows
- Coordinate team workflows: Organize sprints/cycles, assign work, and track progress across teams
- Integrate with development tools: Connect Linear with GitHub, CI/CD, and deployment workflows
- Automate project management: Batch operations, smart filtering, and efficient issue management
- Follow development best practices: Proven patterns for frontend, backend, full-stack, and mobile projects
When to Use This Skill
Use this skill when:
- Starting a new software development project
- Setting up Linear project management
- Managing development workflows (frontend, backend, mobile, full-stack)
- Organizing sprints/cycles and tracking progress
- Creating and managing issues, bugs, and features
- Coordinating between teams (frontend ↔️ backend, iOS ↔️ Android)
- Integrating Linear with GitHub and CI/CD pipelines
- Automating repetitive project management tasks
Skill Contents
Core Documentation
- SKILL.md: Complete Linear MCP server reference with:
- Comprehensive tool catalog (all Linear MCP tools documented)
- Development workflow patterns (feature dev, bug tracking, sprint planning)
- Accelerated development strategies
- Best practices for issues, projects, and team collaboration
- Integration guides for GitHub, CI/CD, Slack
- Quick reference and troubleshooting
Practical Examples
1. Frontend Project Setup (examples/frontend-project-setup.md)
Complete workflow for React/TypeScript frontend projects:
- Project creation with detailed description
- Epic and feature issue breakdown
- Design system implementation tracking
- Cycle organization (sprints)
- Daily workflow queries
- Progress tracking patterns
Use this for: React, Vue, Angular, or any frontend framework projects
2. Mobile App Workflow (examples/mobile-app-workflow.md)
End-to-end mobile development tracking:
- iOS and Android project organization
- Platform-specific issue labeling (ios, android, shared)
- Native integration tracking (CallKit, ConnectionService)
- Bug tracking with device information
- App Store and Play Store submission checklists
- Release management workflows
Use this for: Flutter, React Native, or native iOS/Android projects
3. Full-Stack API Development (examples/full-stack-api-development.md)
Coordinating backend and frontend development:
- API-first development approach
- Parallel backend/frontend work coordination
- Integration point tracking
- API documentation workflows
- Testing strategies (backend + frontend + E2E)
- Deployment coordination
Use this for: Node.js + React, Python + Vue, or any full-stack projects
Key Features
1. Complete MCP Tool Reference
Every Linear MCP server tool documented with:
- Required and optional parameters
- Return data structures
- Usage examples
- Common patterns
- Error handling
Tools covered:
- Issue management (list, create, update, get)
- Project management (list, create, update, get)
- Labels and categorization
- Workflow and status management
- Collaboration (comments, documents)
- Team and user management
- Cycle/sprint planning
2. Development Workflow Patterns
Proven patterns for:
- Feature Development: From idea to deployment with proper tracking
- Bug Triage: Efficient bug handling and resolution workflows
- Sprint Planning: Organizing work into cycles with team coordination
- Project Setup: Complete project initialization for new applications
- GitHub Integration: Linking Linear issues with PRs and deployments
3. Accelerated Development Strategies
- Batch Issue Creation: Set up entire projects efficiently
- Smart Filtering: Reduce cognitive load with focused queries
- Template-Based Issues: Consistent issue creation with templates
- Automated Updates: CI/CD integration for status updates
- Cross-Functional Coordination: Organize frontend/backend/mobile work
4. Best Practices
Comprehensive guidance on:
- Issue Creation: Clear titles, rich descriptions, proper labeling
- Project Organization: Right-sizing projects, label taxonomy
- Workflow Management: Limiting WIP, updating status, completing issues
- Team Collaboration: Clear ownership, communication, celebrations
- Label Taxonomy: Recommended categorization system
5. Integration Patterns
Connect Linear with:
- GitHub: Branch naming, PR linking, auto-status updates
- CI/CD: Test results, deployment tracking, automated comments
- Slack: Notifications, updates, team communication
How to Use This Skill
Installation
1. Copy the linear-dev-accelerator folder to your Claude skills directory 2. Claude will automatically detect and load the skill when relevant
Invoking the Skill
The skill activates automatically when you:
- Mention Linear project management
- Ask about setting up development projects
- Request help with issue tracking
- Discuss sprint/cycle planning
- Need development workflow guidance
Example Usage
You: "I'm starting a new React e-commerce project and want to set it up in Linear"
Claude: [Activates linear-dev-accelerator skill]
Based on the Linear Development Accelerator skill, I'll help you set up a complete
React e-commerce project in Linear. Let me create:
1. The main project with proper description and timeline
2. Epic issues for major features (product catalog, cart, checkout)
3. Child issues for individual components
4. Proper labeling (frontend, react, ui, feature)
5. Organization into sprints/cycles
[Proceeds to use Linear MCP tools with skill knowledge]You: "How should I track a mobile app with both iOS and Android development?"
Claude: [Activates linear-dev-accelerator skill]
For mobile apps with both platforms, I recommend the platform-specific tracking
pattern from the skill. Let me set up:
1. Project with iOS and Android tracking
2. Platform-specific labels (ios, android, shared)
3. Separate issues for platform-specific work
4. Integration issues for coordinating across platforms
[Uses mobile-app-workflow.md patterns]Examples Directory
The examples/ directory contains three comprehensive workflow guides:
1. frontend-project-setup.md: React/TypeScript project from scratch 2. mobile-app-workflow.md: Flutter chat app with iOS + Android 3. full-stack-api-development.md: Node.js API + React frontend
Each example includes:
- Complete Linear MCP tool usage
- Real-world project scenarios
- Copy-paste ready workflows
- Best practices in action
- Daily workflow queries
Skill Capabilities
With this skill, Claude can:
Project Management
- Create comprehensive project structures
- Set up epic issues with child tasks
- Organize work into cycles/sprints
- Track progress and generate reports
- Manage project documentation
Issue Management
- Create issues with rich templates
- Update issue status and properties
- Add detailed comments and context
- Link issues with PRs and deployments
- Track dependencies and blockers
Team Coordination
- Assign work to team members
- Track workload across teams
- Coordinate frontend/backend work
- Manage cross-platform development
- Facilitate daily standups
Development Workflows
- GitHub integration patterns
- CI/CD automation
- Release management
- Bug triage processes
- Testing coordination
Automation
- Batch issue creation
- Smart filtering queries
- Automated status updates
- Template-based workflows
- Metrics and reporting
Quick Start
For Frontend Projects
See examples/frontend-project-setup.md for complete React project setup
For Mobile Projects
See examples/mobile-app-workflow.md for iOS + Android app tracking
For Full-Stack Projects
See examples/full-stack-api-development.md for coordinated API + frontend development
Advanced Usage
Custom Workflows
Adapt the patterns in SKILL.md to your team's specific needs:
- Modify label taxonomies
- Adjust workflow states
- Customize issue templates
- Create team-specific queries
Integration Development
Use the MCP tool reference to build custom integrations:
- Automated issue creation from logs
- Status updates from CI/CD
- Metrics dashboards
- Custom reporting tools
Team Onboarding
Use the skill documentation to onboard teams:
- Share best practices
- Standardize workflows
- Document conventions
- Train on Linear usage
Resources
Linear Documentation
Claude Skills
MCP Servers
Skill Metadata
- Version: 1.0.0
- Category: Project Management, Development Acceleration
- Compatible With: Linear MCP Server, GitHub, CI/CD pipelines
- Last Updated: October 2025
- Research Sources: Linear MCP Server API, Linear Documentation, Real-world development workflows
Contributing
This skill is based on:
- Comprehensive Linear MCP server exploration
- Real-world project management patterns
- Software development best practices
- Feedback from production usage
Suggestions for improvements are welcome!
License
This skill is provided as-is for use with Claude Code and Claude API.
---
Build faster. Ship better. Accelerate development with Linear + Claude.