create-universal-ai-context 2.4.0 → 2.6.0-final

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 (153) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +331 -294
  3. package/bin/create-ai-context.js +1507 -764
  4. package/lib/adapters/aider.js +131 -131
  5. package/lib/adapters/antigravity.js +205 -205
  6. package/lib/adapters/claude.js +397 -397
  7. package/lib/adapters/cline.js +125 -125
  8. package/lib/adapters/continue.js +138 -138
  9. package/lib/adapters/copilot.js +131 -131
  10. package/lib/adapters/index.js +78 -78
  11. package/lib/adapters/windsurf.js +138 -138
  12. package/lib/ai-context-generator.js +234 -234
  13. package/lib/ai-orchestrator.js +432 -432
  14. package/lib/call-tracer.js +444 -444
  15. package/lib/content-preservation.js +243 -243
  16. package/lib/cross-tool-sync/file-watcher.js +274 -274
  17. package/lib/cross-tool-sync/index.js +41 -40
  18. package/lib/cross-tool-sync/sync-manager.js +540 -512
  19. package/lib/cross-tool-sync/sync-service.js +297 -297
  20. package/lib/detector.js +726 -726
  21. package/lib/doc-discovery.js +741 -741
  22. package/lib/drift-checker.js +920 -920
  23. package/lib/environment-detector.js +239 -239
  24. package/lib/index.js +399 -399
  25. package/lib/install-hooks.js +82 -82
  26. package/lib/installer.js +419 -419
  27. package/lib/migrate.js +328 -328
  28. package/lib/placeholder.js +632 -632
  29. package/lib/prompts.js +341 -341
  30. package/lib/smart-merge.js +540 -540
  31. package/lib/spinner.js +60 -60
  32. package/lib/static-analyzer.js +729 -729
  33. package/lib/template-coordination.js +148 -148
  34. package/lib/template-populator.js +843 -843
  35. package/lib/template-renderer.js +392 -392
  36. package/lib/utils/fs-wrapper.js +79 -79
  37. package/lib/utils/path-utils.js +60 -60
  38. package/lib/validate.js +155 -155
  39. package/package.json +1 -1
  40. package/templates/AI_CONTEXT.md.template +245 -245
  41. package/templates/base/README.md +260 -257
  42. package/templates/base/RPI_WORKFLOW_PLAN.md +325 -320
  43. package/templates/base/agents/api-developer.md +76 -76
  44. package/templates/base/agents/context-engineer.md +525 -525
  45. package/templates/base/agents/core-architect.md +76 -76
  46. package/templates/base/agents/database-ops.md +76 -76
  47. package/templates/base/agents/deployment-ops.md +76 -76
  48. package/templates/base/agents/integration-hub.md +76 -76
  49. package/templates/base/analytics/README.md +114 -114
  50. package/templates/base/automation/config.json +58 -58
  51. package/templates/base/automation/generators/code-mapper.js +308 -308
  52. package/templates/base/automation/generators/index-builder.js +321 -321
  53. package/templates/base/automation/hooks/post-commit.sh +83 -83
  54. package/templates/base/automation/hooks/pre-commit.sh +103 -103
  55. package/templates/base/ci-templates/README.md +108 -108
  56. package/templates/base/ci-templates/github-actions/context-check.yml +144 -144
  57. package/templates/base/ci-templates/github-actions/validate-docs.yml +105 -105
  58. package/templates/base/commands/analytics.md +238 -238
  59. package/templates/base/commands/auto-sync.md +172 -172
  60. package/templates/base/commands/collab.md +194 -194
  61. package/templates/base/commands/context-optimize.md +226 -0
  62. package/templates/base/commands/help.md +485 -450
  63. package/templates/base/commands/rpi-implement.md +164 -115
  64. package/templates/base/commands/rpi-plan.md +147 -93
  65. package/templates/base/commands/rpi-research.md +145 -88
  66. package/templates/base/commands/session-resume.md +144 -144
  67. package/templates/base/commands/session-save.md +112 -112
  68. package/templates/base/commands/validate-all.md +77 -77
  69. package/templates/base/commands/verify-docs-current.md +86 -86
  70. package/templates/base/config/base.json +57 -57
  71. package/templates/base/config/environments/development.json +13 -13
  72. package/templates/base/config/environments/production.json +17 -17
  73. package/templates/base/config/environments/staging.json +13 -13
  74. package/templates/base/config/local.json.example +21 -21
  75. package/templates/base/context/.meta/generated-at.json +18 -18
  76. package/templates/base/context/ARCHITECTURE_SNAPSHOT.md +156 -156
  77. package/templates/base/context/CODE_TO_WORKFLOW_MAP.md +94 -94
  78. package/templates/base/context/FILE_OWNERSHIP.md +57 -57
  79. package/templates/base/context/INTEGRATION_POINTS.md +92 -92
  80. package/templates/base/context/KNOWN_GOTCHAS.md +195 -195
  81. package/templates/base/context/TESTING_MAP.md +95 -95
  82. package/templates/base/context/WORKFLOW_INDEX.md +129 -129
  83. package/templates/base/context/workflows/WORKFLOW_TEMPLATE.md +294 -294
  84. package/templates/base/indexes/agents/CAPABILITY_MATRIX.md +255 -255
  85. package/templates/base/indexes/agents/CATEGORY_INDEX.md +44 -44
  86. package/templates/base/indexes/code/CATEGORY_INDEX.md +38 -38
  87. package/templates/base/indexes/routing/CATEGORY_INDEX.md +39 -39
  88. package/templates/base/indexes/search/CATEGORY_INDEX.md +39 -39
  89. package/templates/base/indexes/workflows/CATEGORY_INDEX.md +38 -38
  90. package/templates/base/knowledge/README.md +98 -98
  91. package/templates/base/knowledge/sessions/README.md +88 -88
  92. package/templates/base/knowledge/sessions/TEMPLATE.md +150 -150
  93. package/templates/base/knowledge/shared/decisions/0001-adopt-context-engineering.md +144 -144
  94. package/templates/base/knowledge/shared/decisions/README.md +49 -49
  95. package/templates/base/knowledge/shared/decisions/TEMPLATE.md +123 -123
  96. package/templates/base/knowledge/shared/patterns/README.md +62 -62
  97. package/templates/base/knowledge/shared/patterns/TEMPLATE.md +120 -120
  98. package/templates/base/plans/PLAN_TEMPLATE.md +316 -250
  99. package/templates/base/research/RESEARCH_TEMPLATE.md +245 -153
  100. package/templates/base/schemas/agent.schema.json +141 -141
  101. package/templates/base/schemas/anchors.schema.json +54 -54
  102. package/templates/base/schemas/automation.schema.json +93 -93
  103. package/templates/base/schemas/command.schema.json +134 -134
  104. package/templates/base/schemas/hashes.schema.json +40 -40
  105. package/templates/base/schemas/manifest.schema.json +117 -117
  106. package/templates/base/schemas/plan.schema.json +136 -136
  107. package/templates/base/schemas/research.schema.json +115 -115
  108. package/templates/base/schemas/roles.schema.json +34 -34
  109. package/templates/base/schemas/session.schema.json +77 -77
  110. package/templates/base/schemas/settings.schema.json +244 -244
  111. package/templates/base/schemas/staleness.schema.json +53 -53
  112. package/templates/base/schemas/team-config.schema.json +42 -42
  113. package/templates/base/schemas/workflow.schema.json +126 -126
  114. package/templates/base/session/checkpoints/.gitkeep +2 -2
  115. package/templates/base/session/current/state.json +20 -20
  116. package/templates/base/session/history/.gitkeep +2 -2
  117. package/templates/base/settings.json +3 -3
  118. package/templates/base/standards/COMPATIBILITY.md +219 -219
  119. package/templates/base/standards/EXTENSION_GUIDELINES.md +280 -280
  120. package/templates/base/standards/QUALITY_CHECKLIST.md +211 -211
  121. package/templates/base/standards/README.md +66 -66
  122. package/templates/base/sync/anchors.json +6 -6
  123. package/templates/base/sync/hashes.json +6 -6
  124. package/templates/base/sync/staleness.json +10 -10
  125. package/templates/base/team/README.md +168 -168
  126. package/templates/base/team/config.json +79 -79
  127. package/templates/base/team/roles.json +145 -145
  128. package/templates/base/tools/bin/claude-context.js +151 -151
  129. package/templates/base/tools/lib/anchor-resolver.js +276 -276
  130. package/templates/base/tools/lib/config-loader.js +363 -363
  131. package/templates/base/tools/lib/detector.js +350 -350
  132. package/templates/base/tools/lib/diagnose.js +206 -206
  133. package/templates/base/tools/lib/drift-detector.js +373 -373
  134. package/templates/base/tools/lib/errors.js +199 -199
  135. package/templates/base/tools/lib/index.js +36 -36
  136. package/templates/base/tools/lib/init.js +192 -192
  137. package/templates/base/tools/lib/logger.js +230 -230
  138. package/templates/base/tools/lib/placeholder.js +201 -201
  139. package/templates/base/tools/lib/session-manager.js +354 -354
  140. package/templates/base/tools/lib/validate.js +521 -521
  141. package/templates/base/tools/package.json +49 -49
  142. package/templates/handlebars/aider-config.hbs +146 -80
  143. package/templates/handlebars/antigravity.hbs +377 -377
  144. package/templates/handlebars/claude.hbs +183 -183
  145. package/templates/handlebars/cline.hbs +62 -62
  146. package/templates/handlebars/continue-config.hbs +116 -116
  147. package/templates/handlebars/copilot.hbs +130 -130
  148. package/templates/handlebars/partials/gotcha-list.hbs +11 -11
  149. package/templates/handlebars/partials/header.hbs +3 -3
  150. package/templates/handlebars/partials/workflow-summary.hbs +16 -16
  151. package/templates/handlebars/windsurf-rules.hbs +69 -69
  152. package/templates/hooks/post-commit.hbs +28 -29
  153. package/templates/hooks/pre-commit.hbs +46 -46
@@ -1,377 +1,377 @@
1
- {{!--
2
- Google Antigravity Template
3
- Generates multiple files for .agent/ directory:
4
- - rules/*.md - Workspace rules by category
5
- - workflows/*.md - On-demand /commands
6
- - skills/*.md - Modular capabilities
7
- --}}
8
-
9
- {{!-- ============================================================ --}}
10
- {{!-- RULES: Main Project Identity --}}
11
- {{!-- ============================================================ --}}
12
- {{{fileStart "rules/identity.md"}}}
13
- <!-- Auto-generated by AI Context Engineering v{{metadata.generator_version}} -->
14
- <!-- Generated: {{metadata.timestamp}} -->
15
-
16
- # {{project.name}} - Project Identity
17
-
18
- ## Overview
19
-
20
- - **Name:** {{project.name}}
21
- - **Description:** {{project.description}}
22
- - **Tech Stack:** {{join project.tech_stack ", "}}
23
- - **Primary Language:** {{project.primary_language}}
24
-
25
- ## Quick Commands
26
-
27
- {{#each commands}}
28
- - **{{@key}}:** `{{this}}`
29
- {{/each}}
30
-
31
- ## Architecture
32
-
33
- **Pattern:** {{architecture.pattern}}
34
-
35
- {{#if architecture.layers}}
36
- **Layers:**
37
- {{#each architecture.layers}}
38
- - `{{path}}` - {{purpose}}
39
- {{/each}}
40
- {{/if}}
41
-
42
- ## Key Entry Points
43
-
44
- {{#each key_files.entry_points}}
45
- - `{{this}}`
46
- {{/each}}
47
-
48
- {{#if environment.required}}
49
- ## Environment Variables
50
-
51
- **Required:**
52
- {{#each environment.required}}
53
- - `{{this}}`
54
- {{/each}}
55
-
56
- {{#if environment.optional}}
57
- **Optional:**
58
- {{#each environment.optional}}
59
- - `{{this}}`
60
- {{/each}}
61
- {{/if}}
62
- {{/if}}
63
-
64
- ---
65
-
66
- {{{coordination.footer}}}
67
- {{{fileEnd}}}
68
-
69
- {{!-- ============================================================ --}}
70
- {{!-- RULES: Architecture Details --}}
71
- {{!-- ============================================================ --}}
72
- {{{fileStart "rules/architecture.md"}}}
73
- <!-- Auto-generated by AI Context Engineering -->
74
-
75
- # Architecture Rules for {{project.name}}
76
-
77
- ## Pattern: {{architecture.pattern}}
78
-
79
- {{#each architecture.layers}}
80
- ### Layer: {{name}}
81
-
82
- **Path:** `{{path}}`
83
- **Purpose:** {{purpose}}
84
-
85
- {{/each}}
86
-
87
- ## Key Files by Category
88
-
89
- {{#if key_files.entry_points}}
90
- ### Entry Points
91
- {{#each key_files.entry_points}}
92
- - `{{this}}`
93
- {{/each}}
94
- {{/if}}
95
-
96
- {{#if key_files.api_routes}}
97
- ### API Routes
98
- {{#each key_files.api_routes}}
99
- - `{{this}}`
100
- {{/each}}
101
- {{/if}}
102
-
103
- {{#if key_files.config}}
104
- ### Configuration
105
- {{#each key_files.config}}
106
- - `{{this}}`
107
- {{/each}}
108
- {{/if}}
109
-
110
- ---
111
-
112
- {{{coordination.footer}}}
113
- {{{fileEnd}}}
114
-
115
- {{!-- ============================================================ --}}
116
- {{!-- RULES: Gotchas (Critical Issues) --}}
117
- {{!-- ============================================================ --}}
118
- {{{fileStart "rules/gotchas.md"}}}
119
- <!-- Auto-generated by AI Context Engineering -->
120
-
121
- # Critical Gotchas for {{project.name}}
122
-
123
- These are known issues and pitfalls. Review before making changes.
124
-
125
- {{#if gotchas}}
126
- {{#each gotchas}}
127
- ## {{id}}: {{title}}
128
-
129
- **Severity:** {{severity}}
130
-
131
- **Symptom:** {{symptom}}
132
-
133
- **Fix:**
134
- ```
135
- {{fix}}
136
- ```
137
-
138
- ---
139
-
140
- {{/each}}
141
- {{else}}
142
- *No gotchas documented yet. Add as discovered.*
143
- {{/if}}
144
-
145
- ---
146
-
147
- {{{coordination.footer}}}
148
- {{{fileEnd}}}
149
-
150
- {{!-- ============================================================ --}}
151
- {{!-- RULES: Constraints --}}
152
- {{!-- ============================================================ --}}
153
- {{{fileStart "rules/constraints.md"}}}
154
- <!-- Auto-generated by AI Context Engineering -->
155
-
156
- # Critical Constraints for {{project.name}}
157
-
158
- These rules MUST be followed. Violations may cause production issues.
159
-
160
- {{#if critical_constraints}}
161
- {{#each critical_constraints}}
162
- {{@index}}. {{this}}
163
- {{/each}}
164
- {{else}}
165
- *No constraints documented yet. Add critical rules as identified.*
166
- {{/if}}
167
-
168
- ## Summary
169
-
170
- - Total Constraints: {{length critical_constraints}}
171
- - Gotchas: {{length gotchas}}
172
- - Workflows: {{length workflows}}
173
-
174
- ---
175
-
176
- {{{coordination.footer}}}
177
- {{{fileEnd}}}
178
-
179
- {{!-- ============================================================ --}}
180
- {{!-- RULES: Workflows Summary --}}
181
- {{!-- ============================================================ --}}
182
- {{{fileStart "rules/workflows.md"}}}
183
- <!-- Auto-generated by AI Context Engineering -->
184
-
185
- # Available Workflows for {{project.name}}
186
-
187
- {{#if workflows}}
188
- {{#each workflows}}
189
- ## {{name}}
190
-
191
- **Category:** {{category}} | **Complexity:** {{complexity}}
192
-
193
- {{description}}
194
-
195
- {{#if entry_points}}
196
- **Entry Points:**
197
- {{#each (first entry_points 5)}}
198
- - `{{endpoint}}` - {{file}}:{{line}}
199
- {{/each}}
200
- {{/if}}
201
-
202
- ---
203
-
204
- {{/each}}
205
- {{else}}
206
- *No workflows discovered. Run AI analysis to populate.*
207
- {{/if}}
208
-
209
- ---
210
-
211
- {{{coordination.footer}}}
212
- {{{fileEnd}}}
213
-
214
- {{!-- ============================================================ --}}
215
- {{!-- WORKFLOWS: Command Files --}}
216
- {{!-- ============================================================ --}}
217
-
218
- {{{fileStart "workflows/run.md"}}}
219
- <!-- Auto-generated by AI Context Engineering -->
220
-
221
- # /run - Start Development Server
222
-
223
- ## Command
224
- ```bash
225
- {{commands.dev}}
226
- ```
227
-
228
- ## Description
229
- Starts the {{project.name}} development server.
230
-
231
- ## Prerequisites
232
- - All dependencies installed
233
- - Environment variables configured
234
-
235
- ## Related
236
- - See `rules/identity.md` for full command list
237
-
238
- ---
239
-
240
- {{{coordination.footer}}}
241
- {{{fileEnd}}}
242
-
243
- {{{fileStart "workflows/test.md"}}}
244
- <!-- Auto-generated by AI Context Engineering -->
245
-
246
- # /test - Run Test Suite
247
-
248
- ## Command
249
- ```bash
250
- {{commands.test}}
251
- ```
252
-
253
- ## Description
254
- Runs the test suite for {{project.name}}.
255
-
256
- ## Tips
257
- - Run before committing changes
258
- - Check test coverage reports
259
-
260
- ---
261
-
262
- {{{coordination.footer}}}
263
- {{{fileEnd}}}
264
-
265
- {{{fileStart "workflows/build.md"}}}
266
- <!-- Auto-generated by AI Context Engineering -->
267
-
268
- # /build - Build Project
269
-
270
- ## Command
271
- ```bash
272
- {{commands.build}}
273
- ```
274
-
275
- ## Description
276
- Builds {{project.name}} for production.
277
-
278
- ---
279
-
280
- {{{coordination.footer}}}
281
- {{{fileEnd}}}
282
-
283
- {{!-- ============================================================ --}}
284
- {{!-- SKILLS: Modular Capabilities --}}
285
- {{!-- ============================================================ --}}
286
-
287
- {{{fileStart "skills/debugging.md"}}}
288
- <!-- Auto-generated by AI Context Engineering -->
289
-
290
- # Debugging Skill for {{project.name}}
291
-
292
- ## When to Use
293
- Activate this skill when debugging issues in {{project.name}}.
294
-
295
- {{#if gotchas}}
296
- ## Known Issues
297
-
298
- {{#each gotchas}}
299
- ### {{id}}: {{title}}
300
-
301
- **Severity:** {{severity}}
302
-
303
- **Symptom:** {{symptom}}
304
-
305
- **Quick Fix:**
306
- ```
307
- {{truncate fix 200}}
308
- ```
309
-
310
- {{/each}}
311
- {{/if}}
312
-
313
- ## Debug Commands
314
-
315
- ```bash
316
- # Start dev server
317
- {{commands.dev}}
318
-
319
- # Run tests
320
- {{commands.test}}
321
- ```
322
-
323
- ## Tips
324
-
325
- - Check application logs for errors
326
- - Review stack traces carefully
327
- - Verify environment configuration
328
-
329
- ---
330
-
331
- {{{coordination.footer}}}
332
- {{{fileEnd}}}
333
-
334
- {{{fileStart "skills/implementation.md"}}}
335
- <!-- Auto-generated by AI Context Engineering -->
336
-
337
- # Implementation Skill for {{project.name}}
338
-
339
- ## When to Use
340
- Activate this skill when implementing new features in {{project.name}}.
341
-
342
- ## Architecture Overview
343
-
344
- **Pattern:** {{architecture.pattern}}
345
-
346
- {{#if architecture.layers}}
347
- **Layers:**
348
- {{#each architecture.layers}}
349
- - `{{path}}` - {{purpose}}
350
- {{/each}}
351
- {{/if}}
352
-
353
- ## Code Standards
354
-
355
- 1. Follow existing patterns in the codebase
356
- 2. Add tests for new functionality
357
- 3. Update documentation as needed
358
- 4. Review gotchas before modifying critical areas
359
-
360
- ## Key Files to Reference
361
-
362
- {{#each key_files.entry_points}}
363
- - `{{this}}`
364
- {{/each}}
365
-
366
- {{#if critical_constraints}}
367
- ## Constraints to Follow
368
-
369
- {{#each critical_constraints}}
370
- - {{this}}
371
- {{/each}}
372
- {{/if}}
373
-
374
- ---
375
-
376
- {{{coordination.footer}}}
377
- {{{fileEnd}}}
1
+ {{!--
2
+ Google Antigravity Template
3
+ Generates multiple files for .agent/ directory:
4
+ - rules/*.md - Workspace rules by category
5
+ - workflows/*.md - On-demand /commands
6
+ - skills/*.md - Modular capabilities
7
+ --}}
8
+
9
+ {{!-- ============================================================ --}}
10
+ {{!-- RULES: Main Project Identity --}}
11
+ {{!-- ============================================================ --}}
12
+ {{{fileStart "rules/identity.md"}}}
13
+ <!-- Auto-generated by AI Context Engineering v{{metadata.generator_version}} -->
14
+ <!-- Generated: {{metadata.timestamp}} -->
15
+
16
+ # {{project.name}} - Project Identity
17
+
18
+ ## Overview
19
+
20
+ - **Name:** {{project.name}}
21
+ - **Description:** {{project.description}}
22
+ - **Tech Stack:** {{join project.tech_stack ", "}}
23
+ - **Primary Language:** {{project.primary_language}}
24
+
25
+ ## Quick Commands
26
+
27
+ {{#each commands}}
28
+ - **{{@key}}:** `{{this}}`
29
+ {{/each}}
30
+
31
+ ## Architecture
32
+
33
+ **Pattern:** {{architecture.pattern}}
34
+
35
+ {{#if architecture.layers}}
36
+ **Layers:**
37
+ {{#each architecture.layers}}
38
+ - `{{path}}` - {{purpose}}
39
+ {{/each}}
40
+ {{/if}}
41
+
42
+ ## Key Entry Points
43
+
44
+ {{#each key_files.entry_points}}
45
+ - `{{this}}`
46
+ {{/each}}
47
+
48
+ {{#if environment.required}}
49
+ ## Environment Variables
50
+
51
+ **Required:**
52
+ {{#each environment.required}}
53
+ - `{{this}}`
54
+ {{/each}}
55
+
56
+ {{#if environment.optional}}
57
+ **Optional:**
58
+ {{#each environment.optional}}
59
+ - `{{this}}`
60
+ {{/each}}
61
+ {{/if}}
62
+ {{/if}}
63
+
64
+ ---
65
+
66
+ {{{coordination.footer}}}
67
+ {{{fileEnd}}}
68
+
69
+ {{!-- ============================================================ --}}
70
+ {{!-- RULES: Architecture Details --}}
71
+ {{!-- ============================================================ --}}
72
+ {{{fileStart "rules/architecture.md"}}}
73
+ <!-- Auto-generated by AI Context Engineering -->
74
+
75
+ # Architecture Rules for {{project.name}}
76
+
77
+ ## Pattern: {{architecture.pattern}}
78
+
79
+ {{#each architecture.layers}}
80
+ ### Layer: {{name}}
81
+
82
+ **Path:** `{{path}}`
83
+ **Purpose:** {{purpose}}
84
+
85
+ {{/each}}
86
+
87
+ ## Key Files by Category
88
+
89
+ {{#if key_files.entry_points}}
90
+ ### Entry Points
91
+ {{#each key_files.entry_points}}
92
+ - `{{this}}`
93
+ {{/each}}
94
+ {{/if}}
95
+
96
+ {{#if key_files.api_routes}}
97
+ ### API Routes
98
+ {{#each key_files.api_routes}}
99
+ - `{{this}}`
100
+ {{/each}}
101
+ {{/if}}
102
+
103
+ {{#if key_files.config}}
104
+ ### Configuration
105
+ {{#each key_files.config}}
106
+ - `{{this}}`
107
+ {{/each}}
108
+ {{/if}}
109
+
110
+ ---
111
+
112
+ {{{coordination.footer}}}
113
+ {{{fileEnd}}}
114
+
115
+ {{!-- ============================================================ --}}
116
+ {{!-- RULES: Gotchas (Critical Issues) --}}
117
+ {{!-- ============================================================ --}}
118
+ {{{fileStart "rules/gotchas.md"}}}
119
+ <!-- Auto-generated by AI Context Engineering -->
120
+
121
+ # Critical Gotchas for {{project.name}}
122
+
123
+ These are known issues and pitfalls. Review before making changes.
124
+
125
+ {{#if gotchas}}
126
+ {{#each gotchas}}
127
+ ## {{id}}: {{title}}
128
+
129
+ **Severity:** {{severity}}
130
+
131
+ **Symptom:** {{symptom}}
132
+
133
+ **Fix:**
134
+ ```
135
+ {{fix}}
136
+ ```
137
+
138
+ ---
139
+
140
+ {{/each}}
141
+ {{else}}
142
+ *No gotchas documented yet. Add as discovered.*
143
+ {{/if}}
144
+
145
+ ---
146
+
147
+ {{{coordination.footer}}}
148
+ {{{fileEnd}}}
149
+
150
+ {{!-- ============================================================ --}}
151
+ {{!-- RULES: Constraints --}}
152
+ {{!-- ============================================================ --}}
153
+ {{{fileStart "rules/constraints.md"}}}
154
+ <!-- Auto-generated by AI Context Engineering -->
155
+
156
+ # Critical Constraints for {{project.name}}
157
+
158
+ These rules MUST be followed. Violations may cause production issues.
159
+
160
+ {{#if critical_constraints}}
161
+ {{#each critical_constraints}}
162
+ {{@index}}. {{this}}
163
+ {{/each}}
164
+ {{else}}
165
+ *No constraints documented yet. Add critical rules as identified.*
166
+ {{/if}}
167
+
168
+ ## Summary
169
+
170
+ - Total Constraints: {{length critical_constraints}}
171
+ - Gotchas: {{length gotchas}}
172
+ - Workflows: {{length workflows}}
173
+
174
+ ---
175
+
176
+ {{{coordination.footer}}}
177
+ {{{fileEnd}}}
178
+
179
+ {{!-- ============================================================ --}}
180
+ {{!-- RULES: Workflows Summary --}}
181
+ {{!-- ============================================================ --}}
182
+ {{{fileStart "rules/workflows.md"}}}
183
+ <!-- Auto-generated by AI Context Engineering -->
184
+
185
+ # Available Workflows for {{project.name}}
186
+
187
+ {{#if workflows}}
188
+ {{#each workflows}}
189
+ ## {{name}}
190
+
191
+ **Category:** {{category}} | **Complexity:** {{complexity}}
192
+
193
+ {{description}}
194
+
195
+ {{#if entry_points}}
196
+ **Entry Points:**
197
+ {{#each (first entry_points 5)}}
198
+ - `{{endpoint}}` - {{file}}:{{line}}
199
+ {{/each}}
200
+ {{/if}}
201
+
202
+ ---
203
+
204
+ {{/each}}
205
+ {{else}}
206
+ *No workflows discovered. Run AI analysis to populate.*
207
+ {{/if}}
208
+
209
+ ---
210
+
211
+ {{{coordination.footer}}}
212
+ {{{fileEnd}}}
213
+
214
+ {{!-- ============================================================ --}}
215
+ {{!-- WORKFLOWS: Command Files --}}
216
+ {{!-- ============================================================ --}}
217
+
218
+ {{{fileStart "workflows/run.md"}}}
219
+ <!-- Auto-generated by AI Context Engineering -->
220
+
221
+ # /run - Start Development Server
222
+
223
+ ## Command
224
+ ```bash
225
+ {{commands.dev}}
226
+ ```
227
+
228
+ ## Description
229
+ Starts the {{project.name}} development server.
230
+
231
+ ## Prerequisites
232
+ - All dependencies installed
233
+ - Environment variables configured
234
+
235
+ ## Related
236
+ - See `rules/identity.md` for full command list
237
+
238
+ ---
239
+
240
+ {{{coordination.footer}}}
241
+ {{{fileEnd}}}
242
+
243
+ {{{fileStart "workflows/test.md"}}}
244
+ <!-- Auto-generated by AI Context Engineering -->
245
+
246
+ # /test - Run Test Suite
247
+
248
+ ## Command
249
+ ```bash
250
+ {{commands.test}}
251
+ ```
252
+
253
+ ## Description
254
+ Runs the test suite for {{project.name}}.
255
+
256
+ ## Tips
257
+ - Run before committing changes
258
+ - Check test coverage reports
259
+
260
+ ---
261
+
262
+ {{{coordination.footer}}}
263
+ {{{fileEnd}}}
264
+
265
+ {{{fileStart "workflows/build.md"}}}
266
+ <!-- Auto-generated by AI Context Engineering -->
267
+
268
+ # /build - Build Project
269
+
270
+ ## Command
271
+ ```bash
272
+ {{commands.build}}
273
+ ```
274
+
275
+ ## Description
276
+ Builds {{project.name}} for production.
277
+
278
+ ---
279
+
280
+ {{{coordination.footer}}}
281
+ {{{fileEnd}}}
282
+
283
+ {{!-- ============================================================ --}}
284
+ {{!-- SKILLS: Modular Capabilities --}}
285
+ {{!-- ============================================================ --}}
286
+
287
+ {{{fileStart "skills/debugging.md"}}}
288
+ <!-- Auto-generated by AI Context Engineering -->
289
+
290
+ # Debugging Skill for {{project.name}}
291
+
292
+ ## When to Use
293
+ Activate this skill when debugging issues in {{project.name}}.
294
+
295
+ {{#if gotchas}}
296
+ ## Known Issues
297
+
298
+ {{#each gotchas}}
299
+ ### {{id}}: {{title}}
300
+
301
+ **Severity:** {{severity}}
302
+
303
+ **Symptom:** {{symptom}}
304
+
305
+ **Quick Fix:**
306
+ ```
307
+ {{truncate fix 200}}
308
+ ```
309
+
310
+ {{/each}}
311
+ {{/if}}
312
+
313
+ ## Debug Commands
314
+
315
+ ```bash
316
+ # Start dev server
317
+ {{commands.dev}}
318
+
319
+ # Run tests
320
+ {{commands.test}}
321
+ ```
322
+
323
+ ## Tips
324
+
325
+ - Check application logs for errors
326
+ - Review stack traces carefully
327
+ - Verify environment configuration
328
+
329
+ ---
330
+
331
+ {{{coordination.footer}}}
332
+ {{{fileEnd}}}
333
+
334
+ {{{fileStart "skills/implementation.md"}}}
335
+ <!-- Auto-generated by AI Context Engineering -->
336
+
337
+ # Implementation Skill for {{project.name}}
338
+
339
+ ## When to Use
340
+ Activate this skill when implementing new features in {{project.name}}.
341
+
342
+ ## Architecture Overview
343
+
344
+ **Pattern:** {{architecture.pattern}}
345
+
346
+ {{#if architecture.layers}}
347
+ **Layers:**
348
+ {{#each architecture.layers}}
349
+ - `{{path}}` - {{purpose}}
350
+ {{/each}}
351
+ {{/if}}
352
+
353
+ ## Code Standards
354
+
355
+ 1. Follow existing patterns in the codebase
356
+ 2. Add tests for new functionality
357
+ 3. Update documentation as needed
358
+ 4. Review gotchas before modifying critical areas
359
+
360
+ ## Key Files to Reference
361
+
362
+ {{#each key_files.entry_points}}
363
+ - `{{this}}`
364
+ {{/each}}
365
+
366
+ {{#if critical_constraints}}
367
+ ## Constraints to Follow
368
+
369
+ {{#each critical_constraints}}
370
+ - {{this}}
371
+ {{/each}}
372
+ {{/if}}
373
+
374
+ ---
375
+
376
+ {{{coordination.footer}}}
377
+ {{{fileEnd}}}