cokit-cli 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/FAQ.md +102 -0
  2. package/LICENSE +32 -0
  3. package/QUICK-START.md +37 -0
  4. package/README.md +110 -0
  5. package/bin/cokit.js +4 -0
  6. package/docs/cokit-comprehensive-mapping-guide.md +937 -0
  7. package/docs/cokit-slides.md +205 -0
  8. package/docs/cokit-team-presentation.md +319 -0
  9. package/docs/migration-guide.md +120 -0
  10. package/docs/project-roadmap.md +257 -0
  11. package/package.json +35 -0
  12. package/plans/260106-1102-cokit-implementation/phases/phase-01-cli-tool.md +151 -0
  13. package/plans/260106-1102-cokit-implementation/phases/phase-02-repo-level-templates.md +198 -0
  14. package/plans/260106-1102-cokit-implementation/phases/phase-03-user-level-skills.md +219 -0
  15. package/plans/260106-1102-cokit-implementation/phases/phase-04-prompt-files.md +328 -0
  16. package/plans/260106-1102-cokit-implementation/phases/phase-05-documentation.md +166 -0
  17. package/plans/260106-1102-cokit-implementation/plan.md +130 -0
  18. package/plans/260106-1102-cokit-implementation/research/researcher-01-copilot-skills-spec.md +182 -0
  19. package/plans/260106-1102-cokit-implementation/research/researcher-02-copilot-instructions-prompts.md +201 -0
  20. package/plans/reports/code-reviewer-260106-1718-phase2-repo-templates.md +184 -0
  21. package/plans/reports/code-reviewer-260106-1728-phase3-review.md +486 -0
  22. package/plans/reports/code-reviewer-260106-1742-phase4-prompts.md +235 -0
  23. package/plans/reports/code-reviewer-260106-1753-phase5-docs.md +275 -0
  24. package/plans/reports/docs-manager-260106-1217-phase1-completion.md +45 -0
  25. package/plans/reports/docs-manager-260106-1734-phase3-skills.md +108 -0
  26. package/plans/reports/docs-manager-260106-1746-phase4-prompt-files.md +75 -0
  27. package/plans/reports/project-manager-260106-1734-SUMMARY.md +354 -0
  28. package/plans/reports/project-manager-260106-1734-phase3-completion.md +257 -0
  29. package/plans/reports/project-manager-260106-1734-phase3-to-phase4-transition.md +274 -0
  30. package/plans/reports/project-manager-260106-1734-phase4-kickoff.md +343 -0
  31. package/plans/reports/project-manager-260106-1734-project-status.md +355 -0
  32. package/plans/reports/project-manager-260106-1746-phase4-completion.md +249 -0
  33. package/plans/reports/project-manager-260106-1746-phase4-deliverables.md +350 -0
  34. package/plans/reports/project-manager-260106-1804-project-complete.md +297 -0
  35. package/plans/reports/tester-260106-1717-phase2-templates.md +216 -0
  36. package/plans/reports/tester-260106-1726-phase3-user-skills.md +256 -0
  37. package/plans/reports/tester-260106-1741-phase4-prompts.md +202 -0
  38. package/plans/reports/tester-260106-1751-phase5-docs.md +301 -0
  39. package/skills/code-review/SKILL.md +86 -0
  40. package/skills/code-review/references/code-review-reception.md +76 -0
  41. package/skills/code-review/references/verification-before-completion.md +86 -0
  42. package/skills/debugging/SKILL.md +70 -0
  43. package/skills/debugging/references/root-cause-tracing.md +65 -0
  44. package/skills/debugging/references/systematic-debugging.md +74 -0
  45. package/skills/debugging/references/verification.md +74 -0
  46. package/skills/docs-seeker/SKILL.md +91 -0
  47. package/skills/docs-seeker/references/search-patterns.md +93 -0
  48. package/skills/docs-seeker/references/source-evaluation.md +77 -0
  49. package/skills/planning/SKILL.md +82 -0
  50. package/skills/planning/references/plan-organization.md +88 -0
  51. package/skills/planning/references/research-phase.md +56 -0
  52. package/skills/planning/references/solution-design.md +65 -0
  53. package/skills/sequential-thinking/SKILL.md +80 -0
  54. package/skills/sequential-thinking/references/advanced-techniques.md +88 -0
  55. package/skills/sequential-thinking/references/core-patterns.md +87 -0
  56. package/src/commands/add.js +93 -0
  57. package/src/commands/doctor.js +117 -0
  58. package/src/commands/init.js +152 -0
  59. package/src/commands/list.js +91 -0
  60. package/src/commands/update.js +22 -0
  61. package/src/index.js +23 -0
  62. package/src/utils/colors.js +14 -0
  63. package/src/utils/copy.js +122 -0
  64. package/src/utils/paths.js +35 -0
  65. package/templates/repo/.github/.cokit-version +4 -0
  66. package/templates/repo/.github/AGENTS.md +55 -0
  67. package/templates/repo/.github/copilot-instructions.md +45 -0
  68. package/templates/repo/.github/instructions/backend.instructions.md +35 -0
  69. package/templates/repo/.github/instructions/development.instructions.md +25 -0
  70. package/templates/repo/.github/instructions/frontend.instructions.md +31 -0
  71. package/templates/repo/.github/instructions/testing.instructions.md +31 -0
  72. package/templates/repo/.github/prompts/code.prompt.md +28 -0
  73. package/templates/repo/.github/prompts/docs.prompt.md +23 -0
  74. package/templates/repo/.github/prompts/fix.prompt.md +24 -0
  75. package/templates/repo/.github/prompts/plan.prompt.md +24 -0
  76. package/templates/repo/.github/prompts/review.prompt.md +24 -0
  77. package/templates/repo/.github/prompts/test.prompt.md +23 -0
  78. package/templates/repo/.github/skills/code-review/SKILL.md +46 -0
  79. package/templates/repo/.github/skills/debugging/SKILL.md +34 -0
  80. package/templates/repo/.vscode/settings.json +6 -0
  81. package/templates/repo/prompts/code.prompt.md +40 -0
  82. package/templates/repo/prompts/docs.prompt.md +29 -0
  83. package/templates/repo/prompts/fix.prompt.md +35 -0
  84. package/templates/repo/prompts/plan.prompt.md +41 -0
  85. package/templates/repo/prompts/review.prompt.md +38 -0
  86. package/templates/repo/prompts/test.prompt.md +29 -0
@@ -0,0 +1,23 @@
1
+ ---
2
+ mode: agent
3
+ description: Write and run tests
4
+ ---
5
+
6
+ # Test - Testing
7
+
8
+ You are a testing expert. Help ensure code quality through testing.
9
+
10
+ ## Approach
11
+
12
+ 1. **Understand what to test** - What's the expected behavior?
13
+ 2. **Write tests** - Cover happy path, edge cases, errors
14
+ 3. **Run tests** - Execute and check results
15
+ 4. **Fix failures** - Debug and fix failing tests
16
+
17
+ ## Test Guidelines
18
+
19
+ - Test behavior, not implementation
20
+ - Use descriptive test names
21
+ - Keep tests focused and independent
22
+ - Mock external dependencies
23
+ - Cover edge cases
@@ -0,0 +1,46 @@
1
+ ---
2
+ name: code-review
3
+ description: Code review with security and best practices focus
4
+ ---
5
+
6
+ # Code Review Skill
7
+
8
+ This skill teaches Copilot thorough code review practices.
9
+
10
+ ## When to Activate
11
+
12
+ - User asks for review
13
+ - New code is written
14
+ - Before merging changes
15
+
16
+ ## Review Checklist
17
+
18
+ ### Security (Critical)
19
+ - [ ] No SQL injection vulnerabilities
20
+ - [ ] No XSS vulnerabilities
21
+ - [ ] No hardcoded secrets
22
+ - [ ] Input validation present
23
+ - [ ] Authentication/authorization checked
24
+
25
+ ### Quality
26
+ - [ ] Error handling is complete
27
+ - [ ] Edge cases are handled
28
+ - [ ] Code is readable and maintainable
29
+ - [ ] No unnecessary complexity
30
+
31
+ ### Performance
32
+ - [ ] No obvious bottlenecks
33
+ - [ ] Database queries are optimized
34
+ - [ ] No memory leaks
35
+
36
+ ### Testing
37
+ - [ ] Tests cover new functionality
38
+ - [ ] Tests cover edge cases
39
+ - [ ] All tests pass
40
+
41
+ ## Feedback Style
42
+
43
+ - Be specific with issues
44
+ - Explain why something is problematic
45
+ - Suggest improvements
46
+ - Acknowledge good code
@@ -0,0 +1,34 @@
1
+ ---
2
+ name: debugging
3
+ description: Systematic debugging and root cause analysis for this project
4
+ ---
5
+
6
+ # Debugging Skill
7
+
8
+ This skill teaches Copilot systematic debugging approaches.
9
+
10
+ ## When to Activate
11
+
12
+ - User reports a bug or error
13
+ - Code isn't working as expected
14
+ - User asks to "fix" something
15
+
16
+ ## Core Rule
17
+
18
+ **NO FIXES WITHOUT ROOT CAUSE FIRST**
19
+
20
+ ## Debugging Process
21
+
22
+ 1. **Understand** - What's expected vs actual?
23
+ 2. **Reproduce** - Can you trigger the issue?
24
+ 3. **Isolate** - Where does it fail?
25
+ 4. **Root Cause** - Why does it fail?
26
+ 5. **Fix** - Make minimal change
27
+ 6. **Verify** - Test the fix works
28
+
29
+ ## Anti-Patterns to Avoid
30
+
31
+ - Random changes hoping something works
32
+ - Fixing symptoms instead of causes
33
+ - Skipping reproduction step
34
+ - Not verifying the fix
@@ -0,0 +1,6 @@
1
+ {
2
+ "github.copilot.chat.useAgentSkills": true,
3
+ "github.copilot.enable": {
4
+ "*": true
5
+ }
6
+ }
@@ -0,0 +1,40 @@
1
+ ---
2
+ mode: agent
3
+ description: Implement from existing plan
4
+ ---
5
+ # Implement Plan
6
+
7
+ Implement the specified plan phase.
8
+
9
+ ## Process
10
+
11
+ 1. **Read Plan**
12
+ - Load plan.md completely
13
+ - Identify current phase
14
+ - List tasks to complete
15
+
16
+ 2. **Implement**
17
+ - Work through tasks sequentially
18
+ - Follow existing patterns
19
+ - Run type checks frequently
20
+
21
+ 3. **Test**
22
+ - Write tests for new code
23
+ - Run full test suite
24
+ - Fix any failures
25
+
26
+ 4. **Review**
27
+ - Check for security issues
28
+ - Verify error handling
29
+ - Ensure code quality
30
+
31
+ 5. **Complete**
32
+ - Update plan status
33
+ - Summarize changes
34
+ - List remaining work
35
+
36
+ ## Guidelines
37
+ - Follow YAGNI/KISS/DRY
38
+ - Keep files under 200 lines
39
+ - Document complex logic
40
+ - No TODO without issue tracking
@@ -0,0 +1,29 @@
1
+ ---
2
+ mode: agent
3
+ description: Update project documentation
4
+ ---
5
+ # Update Documentation
6
+
7
+ Update documentation for recent changes.
8
+
9
+ ## Process
10
+
11
+ 1. **Identify Changes**
12
+ - Review recent commits
13
+ - List new features
14
+ - Note API changes
15
+
16
+ 2. **Update Docs**
17
+ - README.md for user-facing changes
18
+ - API docs for endpoint changes
19
+ - Architecture docs for structural changes
20
+
21
+ 3. **Verify**
22
+ - Links work
23
+ - Examples accurate
24
+ - No outdated references
25
+
26
+ ## Guidelines
27
+ - Keep concise
28
+ - Use examples
29
+ - Update table of contents
@@ -0,0 +1,35 @@
1
+ ---
2
+ mode: agent
3
+ description: Debug and fix code issues
4
+ ---
5
+ # Fix Issue
6
+
7
+ Analyze the described issue and fix it systematically.
8
+
9
+ ## Process
10
+
11
+ 1. **Identify Issue Type**
12
+ - Type errors → Check TypeScript config, type definitions
13
+ - UI/UX issues → Check styles, layout, responsiveness
14
+ - Test failures → Run tests, analyze failures
15
+ - Build errors → Check dependencies, config
16
+
17
+ 2. **Investigate Root Cause**
18
+ - Read error messages completely
19
+ - Find working examples in codebase
20
+ - Trace back to source of problem
21
+
22
+ 3. **Apply Fix**
23
+ - Make minimal changes
24
+ - Follow existing patterns
25
+ - Update related tests
26
+
27
+ 4. **Verify**
28
+ - Run tests
29
+ - Check types compile
30
+ - Confirm issue resolved
31
+
32
+ ## Guidelines
33
+ - No fixes without understanding root cause
34
+ - One fix at a time
35
+ - Verify before claiming done
@@ -0,0 +1,41 @@
1
+ ---
2
+ mode: agent
3
+ description: Create implementation plan for features
4
+ ---
5
+ # Create Plan
6
+
7
+ Create a detailed implementation plan for the described task.
8
+
9
+ ## Process
10
+
11
+ 1. **Understand Requirements**
12
+ - Clarify scope and constraints
13
+ - Identify dependencies
14
+ - Note assumptions
15
+
16
+ 2. **Research**
17
+ - Review relevant codebase areas
18
+ - Check existing patterns
19
+ - Identify technical approach
20
+
21
+ 3. **Design Solution**
22
+ - Break into phases
23
+ - List tasks per phase
24
+ - Estimate effort
25
+
26
+ 4. **Document Plan**
27
+ - Create plan file in ./plans/
28
+ - Include success criteria
29
+ - List open questions
30
+
31
+ ## Output
32
+ Create `./plans/{date}-{name}/plan.md` with:
33
+ - Overview (1-3 sentences)
34
+ - Phases table
35
+ - Success criteria checklist
36
+ - Unresolved questions
37
+
38
+ ## Principles
39
+ - YAGNI: Don't over-engineer
40
+ - KISS: Prefer simple solutions
41
+ - DRY: Identify reusable patterns
@@ -0,0 +1,38 @@
1
+ ---
2
+ mode: agent
3
+ description: Review code for issues
4
+ ---
5
+ # Code Review
6
+
7
+ Review the specified code for quality and issues.
8
+
9
+ ## Check Categories
10
+
11
+ ### Security
12
+ - [ ] Input validation
13
+ - [ ] No hardcoded secrets
14
+ - [ ] SQL injection prevention
15
+ - [ ] XSS prevention
16
+
17
+ ### Performance
18
+ - [ ] No N+1 queries
19
+ - [ ] Appropriate caching
20
+ - [ ] No memory leaks
21
+
22
+ ### Quality
23
+ - [ ] YAGNI compliance
24
+ - [ ] KISS compliance
25
+ - [ ] DRY compliance
26
+ - [ ] Error handling
27
+ - [ ] Test coverage
28
+
29
+ ### Maintainability
30
+ - [ ] Clear naming
31
+ - [ ] Reasonable file size
32
+ - [ ] Documentation for complex logic
33
+
34
+ ## Output
35
+ List issues by severity:
36
+ - **Critical**: Must fix before merge
37
+ - **Important**: Should fix soon
38
+ - **Minor**: Nice to have
@@ -0,0 +1,29 @@
1
+ ---
2
+ mode: agent
3
+ description: Run tests and analyze results
4
+ ---
5
+ # Run Tests
6
+
7
+ Run the test suite and analyze results.
8
+
9
+ ## Process
10
+
11
+ 1. **Run Tests**
12
+ - Execute test command (npm test, pytest, etc.)
13
+ - Capture full output
14
+
15
+ 2. **Analyze Results**
16
+ - Count passed/failed/skipped
17
+ - Identify failure patterns
18
+ - Check for flaky tests
19
+
20
+ 3. **Report**
21
+ - Summary: X passed, Y failed, Z skipped
22
+ - List failing tests with error messages
23
+ - Suggest fixes for failures
24
+
25
+ ## If Tests Fail
26
+ - Read error message completely
27
+ - Find root cause before fixing
28
+ - Fix one issue at a time
29
+ - Re-run to verify fix