/** * @akson/cortex-doc-standards - GitHub Projects Integration Standards * * Defines standards for GitHub Projects integration and issue management * that Claude AI must follow when implementing features. */ export interface GitHubProjectsStandards { issueManagement: { trackingMethod: 'issue-descriptions'; progressLocation: 'description-body'; commentsUsage: 'minimal'; statusUpdating: 'real-time'; }; workflowSteps: Array<{ step: number; action: string; required: boolean; tools: string[]; }>; issueStructure: { requiredSections: string[]; checkboxFormat: string; statusFormat: string; dateFormat: string; }; commands: { view: string; edit: string; close: string; }; prioritySystem: { labels: string[]; commands: string[]; }; } export declare const GITHUB_PROJECTS_STANDARDS: GitHubProjectsStandards; export declare const GITHUB_INTEGRATION_TEMPLATE = "## \uD83D\uDCCB GitHub Projects Integration\n\n**CRITICAL: During implementation, actively update GitHub issue descriptions to track progress**\n\n### Claude Implementation Workflow\n1. **When starting work on an issue**: Read the issue description and understand implementation tasks\n2. **As you implement each task**: Update the issue description to mark checkboxes complete `[x]`\n3. **Use `gh issue edit`** to update the issue body directly - NEVER use comments for progress\n4. **Mark status and date** in issue description when making progress\n5. **Reference issues in commits**: \"fix: authentication (closes #35)\"\n\n### Required Commands for Issue Updates\n```bash\ngh issue view 1 # Read current issue state\ngh issue edit 1 --body \"$(cat updated-issue.md)\" # Update issue description\n```\n\n### Issue Structure Claude Must Use\n```markdown\n## Implementation Checklist\n- [x] ~~Task 1: Setup auth middleware~~ \u2705 DONE\n- [ ] Task 2: Add validation **IN PROGRESS**\n- [ ] Tests: Unit tests for auth flow\n\n**Status**: In Progress (1/3 complete)\n**Last Updated**: 2025-09-12\n```\n\n**Why This Matters**: Issue descriptions are the single source of truth for implementation status. Comments get lost, but the issue description shows exactly what's been completed vs. what remains.\n\n### Priority Management with GitHub CLI\n```bash\n# Create issues with priority labels\ngh issue create --title \"Fix auth bug\" --label \"\uD83D\uDC1B bug,priority:high\"\ngh issue create --title \"Add feature\" --label \"\u2728 feature,priority:medium\"\n\n# Update priority on existing issues\ngh issue edit 1 --add-label \"priority:high\"\ngh issue edit 1 --remove-label \"priority:medium\"\n\n# Filter issues by priority\ngh issue list --label \"priority:high\"\ngh issue list --label \"priority:critical\" --state open\n\n# View issues sorted by priority (use GitHub Projects view)\ngh project list --owner antoineschaller\n```\n\n**Project Labels**: \uD83D\uDC1B Bug fixes | \u2728 Features | \uD83C\uDFA8 UI/UX | \uD83D\uDCCA Analytics | \uD83D\uDD10 Security | \uD83D\uDE80 Performance \n**Priority Labels**: `priority:critical` | `priority:high` | `priority:medium` | `priority:low`"; /** * Validates that a CLAUDE.md file contains proper GitHub Projects Integration standards */ export declare function validateGitHubProjectsIntegration(content: string): { isValid: boolean; errors: string[]; warnings: string[]; }; //# sourceMappingURL=github-projects.d.ts.map