agentic-sdlc 1.6.0 → 1.8.1

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 (144) hide show
  1. package/.agent/rules/agent-execution.md +55 -0
  2. package/.agent/rules/ai-enforcement.md +4 -3
  3. package/.agent/rules/artifacts.md +1 -1
  4. package/.agent/rules/auto-learning.md +78 -0
  5. package/.agent/rules/code-quality.md +40 -0
  6. package/.agent/rules/global.md +2 -2
  7. package/.agent/rules/naming-conventions.md +55 -0
  8. package/.agent/skills/role-ba.md +6 -2
  9. package/.agent/skills/role-brain.md +5 -1
  10. package/.agent/skills/role-cloud.md +38 -0
  11. package/.agent/skills/role-dev.md +22 -1
  12. package/.agent/skills/role-devops.md +4 -0
  13. package/.agent/skills/role-game.md +35 -0
  14. package/.agent/skills/role-mobile.md +55 -0
  15. package/.agent/skills/role-orchestrator.md +4 -0
  16. package/.agent/skills/role-pm.md +4 -0
  17. package/.agent/skills/role-po.md +4 -0
  18. package/.agent/skills/role-reporter.md +4 -0
  19. package/.agent/skills/role-research.md +78 -0
  20. package/.agent/skills/role-sa.md +4 -0
  21. package/.agent/skills/role-seca.md +4 -0
  22. package/.agent/skills/role-stakeholder.md +4 -0
  23. package/.agent/skills/role-tester.md +4 -0
  24. package/.agent/skills/role-uiux.md +4 -0
  25. package/.agent/templates/Specification-Template.md +38 -0
  26. package/.agent/templates/ab-comparison-report.md +175 -0
  27. package/.agent/templates/observer-report.md +131 -0
  28. package/.agent/templates/quality-score-report.md +197 -0
  29. package/.agent/templates/self-learning-digest.md +268 -0
  30. package/.agent/templates/system-health-report.md +330 -0
  31. package/.agent/workflows/ab.md +101 -0
  32. package/.agent/workflows/autogen.md +65 -0
  33. package/.agent/workflows/brain.md +48 -37
  34. package/.agent/workflows/commit.md +61 -0
  35. package/.agent/workflows/cycle.md +32 -11
  36. package/.agent/workflows/debug.md +123 -0
  37. package/.agent/workflows/deep-search.md +82 -0
  38. package/.agent/workflows/docs.md +144 -0
  39. package/.agent/workflows/emergency.md +17 -15
  40. package/.agent/workflows/explore.md +15 -9
  41. package/.agent/workflows/housekeeping.md +24 -11
  42. package/.agent/workflows/metrics.md +14 -12
  43. package/.agent/workflows/monitor.md +98 -0
  44. package/.agent/workflows/observe.md +84 -0
  45. package/.agent/workflows/onboarding.md +135 -0
  46. package/.agent/workflows/orchestrator.md +12 -5
  47. package/.agent/workflows/planning.md +126 -0
  48. package/.agent/workflows/refactor.md +132 -0
  49. package/.agent/workflows/release.md +19 -12
  50. package/.agent/workflows/review.md +99 -0
  51. package/.agent/workflows/score.md +104 -0
  52. package/.agent/workflows/sprint.md +16 -14
  53. package/.agent/workflows/validate.md +13 -11
  54. package/.agent/workflows/worktree.md +154 -0
  55. package/CHANGELOG.md +71 -0
  56. package/README.md +12 -4
  57. package/bin/cli.js +142 -16
  58. package/docs/.brain-health-history.json +42 -0
  59. package/docs/.brain-improvements.json +53 -0
  60. package/docs/.brain-learner-log.json +27 -0
  61. package/docs/.brain-scores.json +310 -0
  62. package/docs/architecture/system-flow.mermaid +81 -0
  63. package/docs/artifacts/2026-01-05-enforcement-gates-plan.md +80 -0
  64. package/docs/artifacts/2026-01-05-workflow-analysis.md +231 -0
  65. package/docs/artifacts/README.md +26 -0
  66. package/docs/guides/MCP-GUIDE.md +1 -0
  67. package/docs/reports/2026-01-05-autogen-evaluation.md +64 -0
  68. package/docs/reports/2026-01-05-brain-layer-analysis.md +109 -0
  69. package/docs/reports/2026-01-05-repository-audit.md +253 -0
  70. package/docs/reports/Metrics-Dashboard-2026-01-08.md +29 -0
  71. package/docs/reports/Metrics-Dashboard-Final.md +29 -0
  72. package/docs/reports/Validation-Report-2026-01-05.md +40 -0
  73. package/docs/reports/Validation-Report-2026-01-08.md +40 -0
  74. package/docs/reports/worktrunk-audit.md +94 -0
  75. package/docs/solutions/README.md +96 -0
  76. package/docs/walkthroughs/2026-01-05-audit-implementation.md +36 -0
  77. package/docs/walkthroughs/2026-01-05-autonomy-release.md +54 -0
  78. package/docs/walkthroughs/2026-01-05-enforcement-gates.md +33 -0
  79. package/docs/walkthroughs/2026-01-05-judge-enhancement.md +30 -0
  80. package/docs/walkthroughs/2026-01-05-landing-page-orchestrator.md +52 -0
  81. package/docs/walkthroughs/2026-01-05-validation.md +32 -0
  82. package/docs/walkthroughs/2026-01-05-workflow-audit.md +89 -0
  83. package/docs/walkthroughs/2026-01-05-workflow-refactoring.md +44 -0
  84. package/docs/walkthroughs/2026-01-06-worktrunk-integration.md +41 -0
  85. package/docs/walkthroughs/README.md +25 -0
  86. package/package.json +33 -19
  87. package/.agent/knowledge-base/AUTO-LEARNING-GUIDE.md +0 -327
  88. package/.agent/knowledge-base/HOW-IT-WORKS.md +0 -365
  89. package/.agent/knowledge-base/INDEX.md +0 -43
  90. package/.agent/knowledge-base/README.md +0 -242
  91. package/.agent/knowledge-base/architecture/.gitkeep +0 -1
  92. package/.agent/knowledge-base/architecture/KB-2026-01-01-003-neo4j-graph-database-skills.md +0 -1146
  93. package/.agent/knowledge-base/architecture/README.md +0 -98
  94. package/.agent/knowledge-base/bugs/.gitkeep +0 -1
  95. package/.agent/knowledge-base/bugs/KB-2026-01-02-yaml-special-character-escaping.md +0 -56
  96. package/.agent/knowledge-base/bugs/medium/KB-2026-01-01-001-example-auto-learned.md +0 -198
  97. package/.agent/knowledge-base/features/.gitkeep +0 -1
  98. package/.agent/knowledge-base/features/KB-2026-01-01-001-landing-page-design-trends-2026.md +0 -646
  99. package/.agent/knowledge-base/features/KB-2026-01-01-004-uiux-design-skills-2026.md +0 -945
  100. package/.agent/knowledge-base/features/KB-2026-01-01-005-modern-ai-landing-page-ui.md +0 -310
  101. package/.agent/knowledge-base/features/KB-2026-01-01-006-award-winning-landing-page-patterns.md +0 -324
  102. package/.agent/knowledge-base/features/KB-2026-01-02-001-cleanup-workflow.md +0 -242
  103. package/.agent/knowledge-base/features/KB-2026-01-02-002-landing-page-monorepo-architecture.md +0 -148
  104. package/.agent/knowledge-base/features/KB-2026-01-02-003-premium-glassmorphism-patterns.md +0 -58
  105. package/.agent/knowledge-base/features/KB-2026-01-04-ai-agent-enforcement.md +0 -46
  106. package/.agent/knowledge-base/features/README.md +0 -83
  107. package/.agent/knowledge-base/features/figma-landing-page-workflow.md +0 -311
  108. package/.agent/knowledge-base/features/figma-mcp-sa-guide.md +0 -673
  109. package/.agent/knowledge-base/features/figma-mcp-uiux-guide.md +0 -459
  110. package/.agent/knowledge-base/performance/.gitkeep +0 -1
  111. package/.agent/knowledge-base/performance/KB-2026-01-02-lazy-loading-optimization.md +0 -80
  112. package/.agent/knowledge-base/platform-specific/.gitkeep +0 -1
  113. package/.agent/knowledge-base/platform-specific/KB-2026-01-02-windows-console-encoding.md +0 -56
  114. package/.agent/knowledge-base/role-guides/DEV-KB-Guide.md +0 -527
  115. package/.agent/knowledge-base/role-guides/DEVOPS-KB-Guide.md +0 -491
  116. package/.agent/knowledge-base/role-guides/PM-KB-Guide.md +0 -299
  117. package/.agent/knowledge-base/role-guides/SECA-KB-Guide.md +0 -555
  118. package/.agent/knowledge-base/role-guides/TESTER-KB-Guide.md +0 -519
  119. package/.agent/knowledge-base/security/.gitkeep +0 -1
  120. package/.agent/knowledge-base/security/KB-2026-01-02-input-validation-sanitization.md +0 -74
  121. package/.agent/rules/AUTO-LEARNING.md +0 -418
  122. package/.agent/rules/KNOWLEDGE-BASE.md +0 -45
  123. package/.agent/workflows/compound.md +0 -51
  124. package/.agent/workflows/preflight.md +0 -35
  125. package/.agent/workflows/route.md +0 -160
  126. package/bin/kb +0 -34
  127. package/bin/kb.bat +0 -28
  128. package/bin/kb_cli.py +0 -226
  129. package/bin/lib/README.md +0 -411
  130. package/bin/lib/__init__.py +0 -7
  131. package/bin/lib/__pycache__/kb_add.cpython-313.pyc +0 -0
  132. package/bin/lib/__pycache__/kb_common.cpython-313.pyc +0 -0
  133. package/bin/lib/__pycache__/kb_compound.cpython-313.pyc +0 -0
  134. package/bin/lib/__pycache__/kb_index.cpython-313.pyc +0 -0
  135. package/bin/lib/__pycache__/kb_list.cpython-313.pyc +0 -0
  136. package/bin/lib/__pycache__/kb_search.cpython-313.pyc +0 -0
  137. package/bin/lib/__pycache__/kb_stats.cpython-313.pyc +0 -0
  138. package/bin/lib/kb_add.py +0 -203
  139. package/bin/lib/kb_common.py +0 -224
  140. package/bin/lib/kb_compound.py +0 -250
  141. package/bin/lib/kb_index.py +0 -193
  142. package/bin/lib/kb_list.py +0 -144
  143. package/bin/lib/kb_search.py +0 -121
  144. package/bin/lib/kb_stats.py +0 -153
@@ -1,43 +0,0 @@
1
- # Knowledge Base Index
2
-
3
- **Last Updated:** 2026-01-04 09:00:54
4
-
5
- This index provides a searchable overview of all knowledge base entries.
6
-
7
- ## Statistics
8
-
9
- - **Total Entries:** 12
10
- - **Categories:** 6
11
-
12
- ## Entries by Category
13
-
14
-
15
- ### Features
16
-
17
- - **[Premium Glassmorphism & Framer Motion Patterns](features\KB-2026-01-02-003-premium-glassmorphism-patterns.md)** [medium] - 2026-01-02 - uiux, glassmorphism, framer-motion, react, animations
18
-
19
- ### Bug
20
-
21
- - **[YAML Frontmatter Special Character Escaping](bugs\KB-2026-01-02-yaml-special-character-escaping.md)** [medium] - 2026-01-02 - yaml, parsing, frontmatter, knowledge-base, escaping
22
-
23
- ### Feature
24
-
25
- - **[Landing Page Updated with Monorepo Architecture Features](features\KB-2026-01-02-002-landing-page-monorepo-architecture.md)** [medium] - 2026-01-02 - landing-page, monorepo, architecture, diagram, astro, svg
26
- - **[Modern AI-Style Landing Page UI Enhancement](features\KB-2026-01-01-005-modern-ai-landing-page-ui.md)** [medium] - 2026-01-01 - ui-design, landing-page, ai-aesthetic, glassmorphism, astro
27
- - **[Award-Winning Landing Page Patterns from Awwwards Research](features\KB-2026-01-01-006-award-winning-landing-page-patterns.md)** [medium] - 2026-01-01 - ui-design, landing-page, awwwards, 3d-effects, bento-grid
28
- - **[Figma Landing Page Design & Development Workflow](features\figma-landing-page-workflow.md)** [high] - 2026-01-02 - figma, landing-page, design-to-code, tailwind, astro, mcp, ai-workflow
29
- - **[Figma MCP Integration for @SA](features\figma-mcp-sa-guide.md)** [high] - 2026-01-02 - figma, mcp, sa, architecture, api-design
30
- - **[Figma MCP Integration for @UIUX](features\figma-mcp-uiux-guide.md)** [high] - 2026-01-02 - figma, mcp, uiux, design, code-generation
31
- - **[Cleanup Workflow Implementation - Legacy File Management](features\KB-2026-01-02-001-cleanup-workflow.md)** [high] - 2026-01-02 - cleanup, workflow, maintenance, trash, legacy-files, housekeeping
32
-
33
- ### Performance
34
-
35
- - **[Lazy Loading and Code Splitting Optimization](performance\KB-2026-01-02-lazy-loading-optimization.md)** [medium] - 2026-01-02 - performance, lazy-loading, code-splitting, optimization, web
36
-
37
- ### Platform-Specific
38
-
39
- - **[Windows Console Encoding Fix for Unicode Characters](platform-specific\KB-2026-01-02-windows-console-encoding.md)** [medium] - 2026-01-02 - windows, encoding, python, unicode, console
40
-
41
- ### Security
42
-
43
- - **[Input Validation and Sanitization Best Practices](security\KB-2026-01-02-input-validation-sanitization.md)** [high] - 2026-01-02 - security, validation, sanitization, xss, injection
@@ -1,242 +0,0 @@
1
- # Knowledge Base - Project Memory
2
-
3
- ## Purpose
4
- This knowledge base stores lessons learned, bug patterns, difficult features, and solutions that required multiple attempts. Use this as a reference when encountering similar issues in the future.
5
-
6
- ---
7
-
8
- ## 📁 Structure
9
-
10
- ```
11
- knowledge-base/
12
- ├── README.md # This file
13
- ├── index.md # Searchable index of all entries
14
- ├── bugs/ # Bug patterns and fixes
15
- │ ├── critical/
16
- │ ├── high/
17
- │ ├── medium/
18
- │ └── low/
19
- ├── features/ # Complex feature implementations
20
- │ ├── authentication/
21
- │ ├── performance/
22
- │ ├── integration/
23
- │ └── ui-ux/
24
- ├── architecture/ # Architecture decisions and patterns
25
- ├── security/ # Security issues and solutions
26
- ├── performance/ # Performance optimizations
27
- └── platform-specific/ # Platform-specific issues
28
- ├── web/
29
- ├── mobile/
30
- ├── desktop/
31
- ├── cli/
32
- └── embedded/
33
- ```
34
-
35
- ---
36
-
37
- ## 🔍 How to Use
38
-
39
- ### When to Create an Entry
40
- Create a knowledge entry when:
41
- - ✅ Bug required multiple attempts to fix (3+ attempts)
42
- - ✅ Feature implementation was particularly challenging
43
- - ✅ Solution was non-obvious or counter-intuitive
44
- - ✅ Issue is likely to recur in similar projects
45
- - ✅ Root cause analysis revealed important insights
46
- - ✅ Performance issue required deep investigation
47
- - ✅ Security vulnerability was discovered and fixed
48
-
49
- ### When to Search
50
- Search the knowledge base when:
51
- - 🔍 Encountering a new bug or error
52
- - 🔍 Starting a complex feature implementation
53
- - 🔍 Facing performance issues
54
- - 🔍 Dealing with platform-specific problems
55
- - 🔍 Making architecture decisions
56
- - 🔍 Reviewing security concerns
57
-
58
- ### How to Search
59
-
60
- **1. File-Based Search:**
61
- - **By Category:** Browse folders by type (bugs, features, etc.)
62
- - **By Severity:** Check critical/high priority entries first
63
- - **By Keywords:** Search for error messages, technology names, component names
64
- - **By Index:** Check `INDEX.md` for quick reference
65
-
66
- **2. Neo4j Knowledge Graph:**
67
- ```bash
68
- # Search all skills
69
- python tools/neo4j/query_skills_neo4j.py --all-skills
70
-
71
- # Find skills for specific technology
72
- python tools/neo4j/query_skills_neo4j.py --tech "React"
73
-
74
- # Find related skills
75
- python tools/neo4j/query_skills_neo4j.py --skill "Authentication"
76
-
77
- # Get learning path
78
- python tools/neo4j/query_skills_neo4j.py --learning-path "Architecture"
79
-
80
- # Search by keyword
81
- python tools/neo4j/query_skills_neo4j.py --search "performance"
82
- ```
83
-
84
- **3. Research Agent (Automated):**
85
- ```bash
86
- # Automatically searches both file system and Neo4j
87
- python tools/research/research_agent.py --task "authentication" --type feature
88
- ```
89
-
90
- **See [Neo4j Tools Documentation](../../tools/neo4j/README.md) for complete guide.**
91
-
92
- ---
93
-
94
- ## 📝 Creating an Entry
95
-
96
- ### Step 1: Use the Template
97
- Copy `.agent/templates/Knowledge-Entry-Template.md`
98
-
99
- ### Step 2: Fill in Details
100
- - Provide clear problem description
101
- - Include code snippets
102
- - Document root cause
103
- - Explain solution step-by-step
104
- - Add prevention measures
105
- - **Use YAML frontmatter** for metadata (required for Neo4j sync)
106
-
107
- ### Step 3: Choose Location
108
- Place entry in appropriate folder:
109
- - **Bugs:** `knowledge-base/bugs/[severity]/KB-[date]-[id].md`
110
- - **Features:** `knowledge-base/features/[category]/KB-[date]-[id].md`
111
- - **Architecture:** `knowledge-base/architecture/KB-[date]-[id].md`
112
- - **Security:** `knowledge-base/security/KB-[date]-[id].md`
113
- - **Performance:** `knowledge-base/performance/KB-[date]-[id].md`
114
- - **Platform:** `knowledge-base/platform-specific/[platform]/KB-[date]-[id].md`
115
-
116
- ### Step 4: Sync to Neo4j
117
- ```bash
118
- # Sync your new entry to Neo4j knowledge graph
119
- python tools/neo4j/sync_skills_to_neo4j.py
120
-
121
- # Verify it was synced
122
- python tools/neo4j/query_skills_neo4j.py --all-skills
123
- ```
124
-
125
- ### Step 5: Update Index
126
- Add entry to `INDEX.md` with:
127
- - ID, Title, Category, Tags, Date
128
-
129
- **Note:** Neo4j sync automatically extracts skills, technologies, and relationships from your entry.
130
-
131
- ---
132
-
133
- ## 🏷️ Tagging System
134
-
135
- ### Category Tags
136
- - `#bug-pattern` - Recurring bug patterns
137
- - `#feature-solution` - Complex feature implementations
138
- - `#performance` - Performance optimizations
139
- - `#security` - Security issues
140
- - `#architecture` - Architecture decisions
141
- - `#integration` - Third-party integrations
142
- - `#platform-specific` - Platform-specific issues
143
-
144
- ### Technology Tags
145
- - `#react`, `#nodejs`, `#python`, `#flutter`, etc.
146
- - `#postgresql`, `#mongodb`, `#redis`, etc.
147
- - `#aws`, `#docker`, `#kubernetes`, etc.
148
-
149
- ### Severity Tags
150
- - `#critical` - System breaking, data loss
151
- - `#high` - Major functionality affected
152
- - `#medium` - Moderate impact
153
- - `#low` - Minor issues
154
-
155
- ---
156
-
157
- ## 📊 Entry Naming Convention
158
-
159
- **Format:** `KB-[YYYY-MM-DD]-[###]-[short-title].md`
160
-
161
- **Examples:**
162
- - `KB-2025-12-29-001-react-hydration-error.md`
163
- - `KB-2025-12-29-002-oauth-token-refresh.md`
164
- - `KB-2025-12-29-003-mobile-memory-leak.md`
165
-
166
- ---
167
-
168
- ## 🔄 Maintenance
169
-
170
- ### Regular Reviews
171
- - **Monthly:** Review and update entries
172
- - **Quarterly:** Archive outdated entries
173
- - **Yearly:** Consolidate similar entries
174
-
175
- ### Quality Standards
176
- - ✅ Clear problem description
177
- - ✅ Reproducible steps
178
- - ✅ Working solution
179
- - ✅ Prevention measures
180
- - ✅ Proper tagging
181
-
182
- ### Archiving
183
- Move outdated entries to `knowledge-base/archive/[year]/`
184
-
185
- ---
186
-
187
- ## 📈 Metrics to Track
188
-
189
- Track these metrics in `index.md`:
190
- - Total entries by category
191
- - Most referenced entries
192
- - Average resolution time
193
- - Recurrence rate
194
-
195
- ---
196
-
197
- ## 🎯 Best Practices
198
-
199
- ### Writing Entries
200
- 1. **Be Specific:** Include exact error messages, versions, configurations
201
- 2. **Be Complete:** Document all attempts, not just the final solution
202
- 3. **Be Searchable:** Use clear keywords and tags
203
- 4. **Be Visual:** Include screenshots, diagrams, code snippets
204
- 5. **Be Preventive:** Focus on how to avoid the issue
205
-
206
- ### Using Entries
207
- 1. **Search First:** Always check knowledge base before starting
208
- 2. **Adapt Solutions:** Don't copy-paste blindly, understand the context
209
- 3. **Update Entries:** Add notes if you find better solutions
210
- 4. **Cross-Reference:** Link related entries together
211
-
212
- ---
213
-
214
- ## 🤝 Contributing
215
-
216
- ### Who Can Add Entries
217
- - @DEV - Bug fixes, feature implementations
218
- - @DEVOPS - Infrastructure, deployment issues
219
- - @TESTER - Test patterns, edge cases
220
- - @SECA - Security vulnerabilities
221
- - @SA - Architecture decisions
222
- - @UIUX - UI/UX patterns
223
-
224
- ### Review Process
225
- 1. Create entry using template
226
- 2. Tag @REPORTER for review
227
- 3. @REPORTER verifies completeness
228
- 4. Entry added to index
229
- 5. Team notified
230
-
231
- ---
232
-
233
- ## 📞 Questions?
234
-
235
- If unsure about:
236
- - **What to document:** Ask @PM or @REPORTER
237
- - **Where to place entry:** Check this README or ask @REPORTER
238
- - **How to search:** Use index.md or ask @REPORTER
239
-
240
- ---
241
-
242
- #knowledge-base #documentation #lessons-learned
@@ -1 +0,0 @@
1
- # This folder stores architecture decisions and patterns