contextos-agents 1.6.1 → 2.0.0-beta.2

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 (323) hide show
  1. package/.agents/AGENTS.md +6 -1
  2. package/.agents/adapters/aider/export.js +117 -97
  3. package/.agents/adapters/claude/export.js +68 -26
  4. package/.agents/adapters/copilot/export.js +90 -51
  5. package/.agents/adapters/cursor/export.js +83 -68
  6. package/.agents/adapters/drift-detector.js +196 -0
  7. package/.agents/adapters/gemini/export.js +76 -45
  8. package/.agents/adapters/pure-compiler.js +443 -0
  9. package/.agents/adapters/zed/export.js +109 -62
  10. package/.agents/compiled/registry.v2.json +504 -0
  11. package/.agents/compiled/registry.v2.sha256 +1 -0
  12. package/.agents/compiler/manifest-compiler.js +963 -0
  13. package/.agents/compiler/vendor/yaml.LICENSE.txt +13 -0
  14. package/.agents/compiler/vendor/yaml.SBOM.json +6 -0
  15. package/.agents/compiler/vendor/yaml.js +139 -0
  16. package/.agents/core/profiles/init.yaml +25 -0
  17. package/.agents/core/skills/context-manager/references/context-rules.md +59 -0
  18. package/.agents/core/skills/context-manager/skill.yaml +10 -5
  19. package/.agents/core/skills/context-os/SKILL.md +3 -6
  20. package/.agents/core/skills/context-os/skill.yaml +14 -8
  21. package/.agents/core/skills/engineering-workflow/SKILL.md +1 -1
  22. package/.agents/core/skills/engineering-workflow/skill.yaml +7 -7
  23. package/.agents/core/skills/gemini-precision/SKILL.md +4 -0
  24. package/.agents/core/skills/gemini-precision/skill.yaml +5 -6
  25. package/.agents/core/skills/gstack-roles/SKILL.md +3 -1
  26. package/.agents/core/skills/gstack-roles/skill.yaml +9 -6
  27. package/.agents/core/skills/ponytail-mindset/skill.yaml +7 -7
  28. package/.agents/core/skills/security/skill.yaml +21 -2
  29. package/.agents/ctx.js +587 -111
  30. package/.agents/customization-dx.js +282 -0
  31. package/.agents/doctor.js +877 -33
  32. package/.agents/filesystem/index.js +71 -0
  33. package/.agents/filesystem/journaled-transaction.js +451 -0
  34. package/.agents/filesystem/lockfile-v2.js +275 -0
  35. package/.agents/filesystem/platform-hardening.js +222 -0
  36. package/.agents/filesystem/project-lock.js +218 -0
  37. package/.agents/filesystem/safe-path.js +256 -0
  38. package/.agents/generated/claude/skills/context-os/SKILL.md +1 -1
  39. package/.agents/generated/claude/skills/engineering-workflow/SKILL.md +1 -1
  40. package/.agents/generated/claude/skills/gemini-precision/SKILL.md +4 -0
  41. package/.agents/generated/claude/skills/gstack-roles/SKILL.md +3 -1
  42. package/.agents/generated/gemini/skills/context-os/SKILL.md +2 -2
  43. package/.agents/generated/gemini/skills/engineering-workflow/SKILL.md +1 -1
  44. package/.agents/generated/gemini/skills/gemini-precision/SKILL.md +4 -0
  45. package/.agents/generated/gemini/skills/gstack-roles/SKILL.md +3 -1
  46. package/.agents/plugins/contextos/hooks.json +25 -0
  47. package/.agents/plugins/contextos/plugin.json +19 -0
  48. package/.agents/plugins.js +432 -73
  49. package/.agents/profiles.js +507 -46
  50. package/.agents/resolver.js +50 -414
  51. package/.agents/schemas/attestation.review.v1.json +111 -0
  52. package/.agents/schemas/attestation.verification.v1.json +85 -0
  53. package/.agents/schemas/lockfile.v2.schema.json +134 -0
  54. package/.agents/schemas/profile.v2.schema.json +114 -0
  55. package/.agents/schemas/runtime.thread.v1.json +192 -0
  56. package/.agents/schemas/skill.manifest.v2.json +177 -0
  57. package/.agents/schemas/verification.spec.v1.json +39 -0
  58. package/.agents/schemas/workspace.graph.schema.json +106 -0
  59. package/.agents/stats.js +22 -9
  60. package/.agents/transaction-core/event-store.js +288 -0
  61. package/.agents/transaction-core/idempotency.js +129 -0
  62. package/.agents/transaction-core/ipc-lock.js +311 -0
  63. package/.agents/transaction-core/plugin-supply-chain-bundle.js +436 -0
  64. package/.agents/validate.js +143 -14
  65. package/.agents/watch.js +354 -102
  66. package/.agents/workspace/workspace-graph.js +778 -0
  67. package/README.md +59 -387
  68. package/benchmarks/v2/analysis/statistics.js +140 -0
  69. package/benchmarks/v2/analysis/stats.js +69 -0
  70. package/benchmarks/v2/arms/arm-definitions.js +79 -0
  71. package/benchmarks/v2/dataset.schema.json +34 -0
  72. package/benchmarks/v2/evaluators/index.js +25 -0
  73. package/benchmarks/v2/evaluators/verified-success.js +116 -0
  74. package/benchmarks/v2/harness/runner.js +88 -0
  75. package/benchmarks/v2/pilot-tasks.json +392 -0
  76. package/bin/commands/recover.js +88 -0
  77. package/bin/commands/uninstall.js +207 -0
  78. package/bin/commands/update.js +325 -0
  79. package/bin/commands.js +342 -0
  80. package/bin/index.js +326 -149
  81. package/bin/lib/detector.js +106 -0
  82. package/bin/lib/lockfile.js +253 -0
  83. package/bin/lib/safe-writer.js +290 -0
  84. package/package.json +85 -73
  85. package/registry.json +15 -7
  86. package/registry.schema.json +3 -1
  87. package/registry.v2.schema.json +86 -0
  88. package/.agents/core/profiles/backend.yaml +0 -47
  89. package/.agents/core/profiles/enterprise.yaml +0 -46
  90. package/.agents/core/profiles/frontend.yaml +0 -46
  91. package/.agents/core/profiles/hackathon.yaml +0 -45
  92. package/.agents/core/profiles/mvp.yaml +0 -44
  93. package/.agents/core/profiles/startup.yaml +0 -48
  94. package/.agents/core/skills/adapters/EXAMPLES.md +0 -19
  95. package/.agents/core/skills/adapters/SKILL.md +0 -105
  96. package/.agents/core/skills/adapters/TROUBLESHOOTING.md +0 -7
  97. package/.agents/core/skills/adapters/VALIDATION.json +0 -12
  98. package/.agents/core/skills/adapters/skill.yaml +0 -10
  99. package/.agents/core/skills/architecture-diagrams/SKILL.md +0 -108
  100. package/.agents/core/skills/architecture-diagrams/VALIDATION.json +0 -12
  101. package/.agents/core/skills/architecture-diagrams/skill.yaml +0 -8
  102. package/.agents/core/skills/brutalist-design/SKILL.md +0 -150
  103. package/.agents/core/skills/brutalist-design/VALIDATION.json +0 -12
  104. package/.agents/core/skills/brutalist-design/skill.yaml +0 -8
  105. package/.agents/core/skills/database/EXAMPLES.md +0 -74
  106. package/.agents/core/skills/database/SKILL.md +0 -101
  107. package/.agents/core/skills/database/TROUBLESHOOTING.md +0 -18
  108. package/.agents/core/skills/database/VALIDATION.json +0 -11
  109. package/.agents/core/skills/database/skill.yaml +0 -25
  110. package/.agents/core/skills/ddd/EXAMPLES.md +0 -42
  111. package/.agents/core/skills/ddd/SKILL.md +0 -247
  112. package/.agents/core/skills/ddd/TROUBLESHOOTING.md +0 -19
  113. package/.agents/core/skills/ddd/VALIDATION.json +0 -12
  114. package/.agents/core/skills/ddd/ddd.md +0 -178
  115. package/.agents/core/skills/ddd/skill.yaml +0 -10
  116. package/.agents/core/skills/decisions/EXAMPLES.md +0 -35
  117. package/.agents/core/skills/decisions/SKILL.md +0 -90
  118. package/.agents/core/skills/decisions/TROUBLESHOOTING.md +0 -13
  119. package/.agents/core/skills/decisions/VALIDATION.json +0 -12
  120. package/.agents/core/skills/decisions/skill.yaml +0 -10
  121. package/.agents/core/skills/docker/EXAMPLES.md +0 -56
  122. package/.agents/core/skills/docker/SKILL.md +0 -63
  123. package/.agents/core/skills/docker/TROUBLESHOOTING.md +0 -18
  124. package/.agents/core/skills/docker/VALIDATION.json +0 -11
  125. package/.agents/core/skills/docker/skill.yaml +0 -23
  126. package/.agents/core/skills/fastapi/EXAMPLES.md +0 -36
  127. package/.agents/core/skills/fastapi/SKILL.md +0 -148
  128. package/.agents/core/skills/fastapi/TROUBLESHOOTING.md +0 -19
  129. package/.agents/core/skills/fastapi/VALIDATION.json +0 -12
  130. package/.agents/core/skills/fastapi/fastapi.md +0 -112
  131. package/.agents/core/skills/fastapi/skill.yaml +0 -10
  132. package/.agents/core/skills/generators/EXAMPLES.md +0 -19
  133. package/.agents/core/skills/generators/SKILL.md +0 -112
  134. package/.agents/core/skills/generators/TROUBLESHOOTING.md +0 -7
  135. package/.agents/core/skills/generators/VALIDATION.json +0 -12
  136. package/.agents/core/skills/generators/skill.yaml +0 -10
  137. package/.agents/core/skills/generators/templates/API.md +0 -77
  138. package/.agents/core/skills/generators/templates/ARCHITECTURE.md +0 -70
  139. package/.agents/core/skills/generators/templates/DATABASE.md +0 -42
  140. package/.agents/core/skills/generators/templates/DECISION.md +0 -46
  141. package/.agents/core/skills/generators/templates/PRD.md +0 -67
  142. package/.agents/core/skills/generators/templates/PROJECT_GRAPH.md +0 -56
  143. package/.agents/core/skills/generators/templates/ROADMAP.md +0 -51
  144. package/.agents/core/skills/generators/templates/TASKS.md +0 -43
  145. package/.agents/core/skills/generators/templates/UI.md +0 -73
  146. package/.agents/core/skills/graphify/EXAMPLES.md +0 -73
  147. package/.agents/core/skills/graphify/SKILL.md +0 -130
  148. package/.agents/core/skills/graphify/VALIDATION.json +0 -12
  149. package/.agents/core/skills/graphify/skill.yaml +0 -13
  150. package/.agents/core/skills/impeccable-design/EXAMPLES.md +0 -26
  151. package/.agents/core/skills/impeccable-design/SKILL.md +0 -201
  152. package/.agents/core/skills/impeccable-design/TROUBLESHOOTING.md +0 -19
  153. package/.agents/core/skills/impeccable-design/VALIDATION.json +0 -12
  154. package/.agents/core/skills/impeccable-design/skill.yaml +0 -14
  155. package/.agents/core/skills/interview-me/SKILL.md +0 -97
  156. package/.agents/core/skills/interview-me/VALIDATION.json +0 -12
  157. package/.agents/core/skills/interview-me/skill.yaml +0 -8
  158. package/.agents/core/skills/microservices/EXAMPLES.md +0 -38
  159. package/.agents/core/skills/microservices/SKILL.md +0 -164
  160. package/.agents/core/skills/microservices/TROUBLESHOOTING.md +0 -19
  161. package/.agents/core/skills/microservices/VALIDATION.json +0 -12
  162. package/.agents/core/skills/microservices/microservices.md +0 -119
  163. package/.agents/core/skills/microservices/skill.yaml +0 -10
  164. package/.agents/core/skills/minimalist-design/SKILL.md +0 -113
  165. package/.agents/core/skills/minimalist-design/VALIDATION.json +0 -12
  166. package/.agents/core/skills/minimalist-design/skill.yaml +0 -8
  167. package/.agents/core/skills/nestjs/EXAMPLES.md +0 -40
  168. package/.agents/core/skills/nestjs/SKILL.md +0 -139
  169. package/.agents/core/skills/nestjs/TROUBLESHOOTING.md +0 -19
  170. package/.agents/core/skills/nestjs/VALIDATION.json +0 -12
  171. package/.agents/core/skills/nestjs/nestjs.md +0 -103
  172. package/.agents/core/skills/nestjs/skill.yaml +0 -10
  173. package/.agents/core/skills/nextjs/EXAMPLES.md +0 -40
  174. package/.agents/core/skills/nextjs/SKILL.md +0 -163
  175. package/.agents/core/skills/nextjs/TROUBLESHOOTING.md +0 -19
  176. package/.agents/core/skills/nextjs/VALIDATION.json +0 -12
  177. package/.agents/core/skills/nextjs/nextjs.md +0 -67
  178. package/.agents/core/skills/nextjs/skill.yaml +0 -10
  179. package/.agents/core/skills/node/EXAMPLES.md +0 -80
  180. package/.agents/core/skills/node/SKILL.md +0 -128
  181. package/.agents/core/skills/node/TROUBLESHOOTING.md +0 -19
  182. package/.agents/core/skills/node/VALIDATION.json +0 -12
  183. package/.agents/core/skills/node/node.md +0 -87
  184. package/.agents/core/skills/node/skill.yaml +0 -10
  185. package/.agents/core/skills/performance/EXAMPLES.md +0 -30
  186. package/.agents/core/skills/performance/SKILL.md +0 -75
  187. package/.agents/core/skills/performance/TROUBLESHOOTING.md +0 -19
  188. package/.agents/core/skills/performance/VALIDATION.json +0 -12
  189. package/.agents/core/skills/performance/performance.md +0 -52
  190. package/.agents/core/skills/performance/skill.yaml +0 -10
  191. package/.agents/core/skills/react/EXAMPLES.md +0 -79
  192. package/.agents/core/skills/react/SKILL.md +0 -132
  193. package/.agents/core/skills/react/TROUBLESHOOTING.md +0 -19
  194. package/.agents/core/skills/react/VALIDATION.json +0 -12
  195. package/.agents/core/skills/react/react.md +0 -93
  196. package/.agents/core/skills/react/skill.yaml +0 -10
  197. package/.agents/core/skills/react-best-practices/SKILL.md +0 -155
  198. package/.agents/core/skills/react-best-practices/VALIDATION.json +0 -12
  199. package/.agents/core/skills/react-best-practices/skill.yaml +0 -10
  200. package/.agents/core/skills/redesign-audit/SKILL.md +0 -117
  201. package/.agents/core/skills/redesign-audit/VALIDATION.json +0 -12
  202. package/.agents/core/skills/redesign-audit/skill.yaml +0 -8
  203. package/.agents/core/skills/soft-design/SKILL.md +0 -108
  204. package/.agents/core/skills/soft-design/VALIDATION.json +0 -12
  205. package/.agents/core/skills/soft-design/skill.yaml +0 -8
  206. package/.agents/core/skills/state-management/EXAMPLES.md +0 -56
  207. package/.agents/core/skills/state-management/SKILL.md +0 -48
  208. package/.agents/core/skills/state-management/TROUBLESHOOTING.md +0 -18
  209. package/.agents/core/skills/state-management/VALIDATION.json +0 -11
  210. package/.agents/core/skills/state-management/skill.yaml +0 -22
  211. package/.agents/core/skills/subagent-orchestrator/SKILL.md +0 -100
  212. package/.agents/core/skills/subagent-orchestrator/VALIDATION.json +0 -12
  213. package/.agents/core/skills/subagent-orchestrator/skill.yaml +0 -8
  214. package/.agents/core/skills/system-design/EXAMPLES.md +0 -75
  215. package/.agents/core/skills/system-design/SKILL.md +0 -419
  216. package/.agents/core/skills/system-design/TROUBLESHOOTING.md +0 -19
  217. package/.agents/core/skills/system-design/VALIDATION.json +0 -12
  218. package/.agents/core/skills/system-design/skill.yaml +0 -13
  219. package/.agents/core/skills/system-design/system-design.md +0 -112
  220. package/.agents/core/skills/testing/EXAMPLES.md +0 -71
  221. package/.agents/core/skills/testing/SKILL.md +0 -70
  222. package/.agents/core/skills/testing/TROUBLESHOOTING.md +0 -18
  223. package/.agents/core/skills/testing/VALIDATION.json +0 -11
  224. package/.agents/core/skills/testing/skill.yaml +0 -26
  225. package/.agents/core/skills/typescript/EXAMPLES.md +0 -64
  226. package/.agents/core/skills/typescript/SKILL.md +0 -112
  227. package/.agents/core/skills/typescript/TROUBLESHOOTING.md +0 -19
  228. package/.agents/core/skills/typescript/VALIDATION.json +0 -12
  229. package/.agents/core/skills/typescript/skill.yaml +0 -10
  230. package/.agents/core/skills/typescript/typescript.md +0 -71
  231. package/.agents/core/skills/ui-design/EXAMPLES.md +0 -21
  232. package/.agents/core/skills/ui-design/SKILL.md +0 -124
  233. package/.agents/core/skills/ui-design/TROUBLESHOOTING.md +0 -19
  234. package/.agents/core/skills/ui-design/VALIDATION.json +0 -12
  235. package/.agents/core/skills/ui-design/skill.yaml +0 -10
  236. package/.agents/core/skills/ui-design/ui.md +0 -88
  237. package/.agents/core/skills/ui-ux-pro/EXAMPLES.md +0 -62
  238. package/.agents/core/skills/ui-ux-pro/SKILL.md +0 -375
  239. package/.agents/core/skills/ui-ux-pro/TROUBLESHOOTING.md +0 -19
  240. package/.agents/core/skills/ui-ux-pro/VALIDATION.json +0 -12
  241. package/.agents/core/skills/ui-ux-pro/skill.yaml +0 -13
  242. package/.agents/core/skills/ux-design/EXAMPLES.md +0 -36
  243. package/.agents/core/skills/ux-design/SKILL.md +0 -116
  244. package/.agents/core/skills/ux-design/TROUBLESHOOTING.md +0 -19
  245. package/.agents/core/skills/ux-design/VALIDATION.json +0 -12
  246. package/.agents/core/skills/ux-design/skill.yaml +0 -10
  247. package/.agents/core/skills/ux-design/ux.md +0 -80
  248. package/.agents/core/skills/vercel-optimize/SKILL.md +0 -83
  249. package/.agents/core/skills/vercel-optimize/VALIDATION.json +0 -12
  250. package/.agents/core/skills/vercel-optimize/skill.yaml +0 -10
  251. package/.agents/core/skills/web-accessibility/EXAMPLES.md +0 -39
  252. package/.agents/core/skills/web-accessibility/SKILL.md +0 -170
  253. package/.agents/core/skills/web-accessibility/TROUBLESHOOTING.md +0 -19
  254. package/.agents/core/skills/web-accessibility/VALIDATION.json +0 -12
  255. package/.agents/core/skills/web-accessibility/accessibility.md +0 -63
  256. package/.agents/core/skills/web-accessibility/skill.yaml +0 -10
  257. package/.agents/generated/claude/skills/adapters/SKILL.md +0 -126
  258. package/.agents/generated/claude/skills/architecture-diagrams/SKILL.md +0 -101
  259. package/.agents/generated/claude/skills/brutalist-design/SKILL.md +0 -145
  260. package/.agents/generated/claude/skills/database/SKILL.md +0 -191
  261. package/.agents/generated/claude/skills/ddd/SKILL.md +0 -305
  262. package/.agents/generated/claude/skills/decisions/SKILL.md +0 -134
  263. package/.agents/generated/claude/skills/docker/SKILL.md +0 -135
  264. package/.agents/generated/claude/skills/fastapi/SKILL.md +0 -200
  265. package/.agents/generated/claude/skills/generators/SKILL.md +0 -133
  266. package/.agents/generated/claude/skills/graphify/SKILL.md +0 -198
  267. package/.agents/generated/claude/skills/impeccable-design/SKILL.md +0 -241
  268. package/.agents/generated/claude/skills/interview-me/SKILL.md +0 -90
  269. package/.agents/generated/claude/skills/microservices/SKILL.md +0 -218
  270. package/.agents/generated/claude/skills/minimalist-design/SKILL.md +0 -108
  271. package/.agents/generated/claude/skills/nestjs/SKILL.md +0 -195
  272. package/.agents/generated/claude/skills/nextjs/SKILL.md +0 -219
  273. package/.agents/generated/claude/skills/node/SKILL.md +0 -224
  274. package/.agents/generated/claude/skills/performance/SKILL.md +0 -121
  275. package/.agents/generated/claude/skills/react/SKILL.md +0 -227
  276. package/.agents/generated/claude/skills/react-best-practices/SKILL.md +0 -146
  277. package/.agents/generated/claude/skills/redesign-audit/SKILL.md +0 -112
  278. package/.agents/generated/claude/skills/soft-design/SKILL.md +0 -103
  279. package/.agents/generated/claude/skills/state-management/SKILL.md +0 -120
  280. package/.agents/generated/claude/skills/subagent-orchestrator/SKILL.md +0 -93
  281. package/.agents/generated/claude/skills/system-design/SKILL.md +0 -507
  282. package/.agents/generated/claude/skills/testing/SKILL.md +0 -157
  283. package/.agents/generated/claude/skills/typescript/SKILL.md +0 -192
  284. package/.agents/generated/claude/skills/ui-design/SKILL.md +0 -161
  285. package/.agents/generated/claude/skills/ui-ux-pro/SKILL.md +0 -451
  286. package/.agents/generated/claude/skills/ux-design/SKILL.md +0 -168
  287. package/.agents/generated/claude/skills/vercel-optimize/SKILL.md +0 -76
  288. package/.agents/generated/claude/skills/web-accessibility/SKILL.md +0 -225
  289. package/.agents/generated/gemini/skills/adapters/SKILL.md +0 -135
  290. package/.agents/generated/gemini/skills/architecture-diagrams/SKILL.md +0 -107
  291. package/.agents/generated/gemini/skills/brutalist-design/SKILL.md +0 -151
  292. package/.agents/generated/gemini/skills/database/SKILL.md +0 -200
  293. package/.agents/generated/gemini/skills/ddd/SKILL.md +0 -314
  294. package/.agents/generated/gemini/skills/decisions/SKILL.md +0 -143
  295. package/.agents/generated/gemini/skills/docker/SKILL.md +0 -144
  296. package/.agents/generated/gemini/skills/fastapi/SKILL.md +0 -209
  297. package/.agents/generated/gemini/skills/generators/SKILL.md +0 -142
  298. package/.agents/generated/gemini/skills/graphify/SKILL.md +0 -205
  299. package/.agents/generated/gemini/skills/impeccable-design/SKILL.md +0 -250
  300. package/.agents/generated/gemini/skills/interview-me/SKILL.md +0 -96
  301. package/.agents/generated/gemini/skills/microservices/SKILL.md +0 -227
  302. package/.agents/generated/gemini/skills/minimalist-design/SKILL.md +0 -114
  303. package/.agents/generated/gemini/skills/nestjs/SKILL.md +0 -204
  304. package/.agents/generated/gemini/skills/nextjs/SKILL.md +0 -298
  305. package/.agents/generated/gemini/skills/node/SKILL.md +0 -323
  306. package/.agents/generated/gemini/skills/performance/SKILL.md +0 -185
  307. package/.agents/generated/gemini/skills/react/SKILL.md +0 -332
  308. package/.agents/generated/gemini/skills/react-best-practices/SKILL.md +0 -152
  309. package/.agents/generated/gemini/skills/redesign-audit/SKILL.md +0 -118
  310. package/.agents/generated/gemini/skills/soft-design/SKILL.md +0 -109
  311. package/.agents/generated/gemini/skills/state-management/SKILL.md +0 -129
  312. package/.agents/generated/gemini/skills/subagent-orchestrator/SKILL.md +0 -99
  313. package/.agents/generated/gemini/skills/system-design/SKILL.md +0 -631
  314. package/.agents/generated/gemini/skills/testing/SKILL.md +0 -166
  315. package/.agents/generated/gemini/skills/typescript/SKILL.md +0 -275
  316. package/.agents/generated/gemini/skills/ui-design/SKILL.md +0 -170
  317. package/.agents/generated/gemini/skills/ui-ux-pro/SKILL.md +0 -460
  318. package/.agents/generated/gemini/skills/ux-design/SKILL.md +0 -177
  319. package/.agents/generated/gemini/skills/vercel-optimize/SKILL.md +0 -82
  320. package/.agents/generated/gemini/skills/web-accessibility/SKILL.md +0 -300
  321. package/.agents/mcp/runtime.py +0 -470
  322. package/.agents/mcp/server.mjs +0 -189271
  323. package/benchmarks/gemini-issues.js +0 -533
@@ -1,130 +0,0 @@
1
- ---
2
- name: graphify
3
- description: >
4
- Transforms entire codebases into structured knowledge graphs via Tree-sitter AST parsing.
5
- Eliminates context window burn, enables precise dependency mapping, and identifies architectural god nodes.
6
- ---
7
-
8
- # graphify
9
-
10
- ## Overview
11
-
12
- **Graphify** is a codebase mapping and context optimization engine. Instead of feeding raw directory trees or entire source files into an agent's context window, Graphify leverages local **Tree-sitter** AST parsing to construct a deterministic, queryable knowledge graph (`graph.json`, `GRAPH_REPORT.md`, `graph.html`).
13
-
14
- This skill instructs agents how to build, query, and maintain codebase graphs to navigate complex architectures with near-zero token overhead.
15
-
16
- ## When to Use
17
-
18
- Activate whenever:
19
-
20
- - Working in large repositories (10k+ LOC) where full-file reads cause context overflow.
21
- - Performing cross-module refactorings and needing to determine exact dependency **blast radius**.
22
- - Onboarding onto an unfamiliar codebase or mapping legacy service boundaries.
23
- - The user asks to "map the codebase", "show dependency graph", "find central components", or "run graphify".
24
- - Working alongside `context-manager` to supply an automated `PROJECT_GRAPH.md` / `graph.json`.
25
-
26
- ## Rules & Patterns
27
-
28
- ### 1. The Graph-First Navigation Protocol
29
-
30
- Before opening and reading arbitrary source files in a large project:
31
-
32
- 1. **Check for Existing Artifacts**:
33
- - Inspect if `graph.json` or `GRAPH_REPORT.md` exists in the project root or `.graphify/`.
34
- - If present, query `graph.json` or read `GRAPH_REPORT.md` first to locate target modules.
35
- 2. **Deterministic CLI Execution**:
36
- - If missing or stale, generate the graph using the Python package (`pip install graphifyy`):
37
-
38
- ```bash
39
- graphify run .
40
- ```
41
-
42
- - For live development sessions, run in watch mode:
43
-
44
- ```bash
45
- graphify watch .
46
- ```
47
-
48
- 3. **Inspect God Nodes**:
49
- - Always check the "God Nodes" section of `GRAPH_REPORT.md`. These represent high-centrality modules (e.g., core configs, base models, central dispatchers). Changes to god nodes have the highest blast radius.
50
-
51
- ### 2. Context Safety Rules
52
-
53
- - **Never load `graph.html` into agent context**: `graph.html` is an interactive visualization for humans in the browser; reading it burns tokens needlessly.
54
- - **Selective JSON Querying**: Do not dump the entire `graph.json` into prompt context if it exceeds 50KB. Use targeted grep/jq queries to extract specific node neighbors.
55
- - **Git Hygiene**: Add `graph.html` and `.graphify/cache` to `.gitignore`. Keep `GRAPH_REPORT.md` committed only if the team uses it as shared documentation.
56
-
57
- ### 3. Blast Radius Verification
58
-
59
- When modifying a function, class, or interface:
60
-
61
- 1. Locate the symbol's node in `graph.json`.
62
- 2. Extract all inbound edges (`dependents` / `callers`).
63
- 3. Formulate the verification plan specifically around those dependent call sites.
64
-
65
- ---
66
-
67
- ## Code Examples
68
-
69
- ### Installing and Running Graphify
70
-
71
- ```bash
72
- # Install graphify CLI (package name is graphifyy on PyPI)
73
- pip install graphifyy
74
-
75
- # Generate knowledge graph and markdown architectural report
76
- graphify run ./src --output .graphify/
77
-
78
- # View interactive visualization locally
79
- open .graphify/graph.html
80
- ```
81
-
82
- ### Querying Node Dependencies via Shell
83
-
84
- ```bash
85
- # Find dependents of a critical module in graph.json without loading entire file
86
- node -e "
87
- const g = require('./.graphify/graph.json');
88
- const target = 'UserService';
89
- const inbound = g.edges.filter(e => e.target === target).map(e => e.source);
90
- console.log('Modules dependent on ' + target + ':', inbound);
91
- "
92
- ```
93
-
94
- ### Git Pre-Commit Hook Integration
95
-
96
- ```bash
97
- #!/bin/sh
98
- # .git/hooks/pre-commit: ensure GRAPH_REPORT.md remains fresh
99
- if command -v graphify >/dev/null 2>&1; then
100
- graphify run . --report-only
101
- git add GRAPH_REPORT.md
102
- fi
103
- ```
104
-
105
- ---
106
-
107
- ## Validation Checklist
108
-
109
- - [ ] `graph.json` and `GRAPH_REPORT.md` are generated without syntax errors.
110
- - [ ] Central "God Nodes" are identified and accounted for in the implementation plan.
111
- - [ ] No heavy visualization artifacts (`graph.html`, raw SVG dumps) are ingested into agent prompt context.
112
- - [ ] Inbound dependencies (callers) are checked before modifying exported signatures.
113
- - [ ] `.gitignore` properly excludes local graph caches and visualization outputs.
114
-
115
- ---
116
-
117
- ## Common Mistakes
118
-
119
- - **Context Window Flooding**: Ingesting the complete `graph.json` of a 500k LOC repository into agent context instead of slicing target subgraphs.
120
- - **Stale Graph Fallacy**: Assuming `graph.json` is up to date after heavy code refactorings without re-running `graphify run` or using `--watch`.
121
- - **Ignoring Semantic Non-Code Files**: Neglecting SQL migrations, OpenAPI specs, and docker configs during graph extraction.
122
- - **Mistaking Package Name**: Trying to install `pip install graphify` instead of the official PyPI package `graphifyy`.
123
-
124
- ---
125
-
126
- ## Integration Notes
127
-
128
- - **Synergy with `context-manager`**: Graphify serves as the automated backend engine for `context-manager`. Instead of manually maintaining `docs/PROJECT_GRAPH.md`, run Graphify to keep `graph.json` current.
129
- - **Synergy with `system-design`**: Use `GRAPH_REPORT.md` to ground architectural proposals in actual codebase topology.
130
- - **Synergy with `architecture-diagrams`**: The nodes and edges extracted in `graph.json` can be directly mapped into animated SVG C4 architecture diagrams.
@@ -1,12 +0,0 @@
1
- {
2
- "$schema": "http://json-schema.org/draft-07/schema#",
3
- "type": "object",
4
- "properties": {
5
- "rules_followed": {
6
- "type": "boolean"
7
- }
8
- },
9
- "required": [
10
- "rules_followed"
11
- ]
12
- }
@@ -1,13 +0,0 @@
1
- name: graphify
2
- description: Codebase knowledge graph generator via Tree-sitter AST parsing and semantic indexing. Minimizes token consumption and maps dependency blast radius.
3
- tags:
4
- - knowledge-graph
5
- - ast
6
- - tree-sitter
7
- - dependencies
8
- - context-optimization
9
- - architecture
10
- version: 1.0.0
11
- optional:
12
- - context-manager
13
- - system-design
@@ -1,26 +0,0 @@
1
- # impeccable-design Examples — Anti-patterns vs ContextOS Standard
2
-
3
- ## Example 1: Dark Mode Surfaces & Elevation
4
-
5
- ### Anti-pattern: Pure Black with Flat Cards
6
-
7
- ```css
8
- /* BAD: Pure #000000 background with harsh pure white borders and flat cards */
9
- body { background-color: #000000; color: #ffffff; }
10
- .card { background-color: #111111; border: 1px solid #ffffff; }
11
- ```
12
-
13
- ### Best practice: ContextOS Standard (Atmospheric Depth & Tinted Surfaces)
14
-
15
- ```css
16
- /* GOOD: Tinted dark background with layered elevation surfaces and subtle border */
17
- body {
18
- background-color: #0B0D13; /* Tinted with subtle deep blue */
19
- color: #E2E8F0;
20
- }
21
- .surface-1 {
22
- background-color: #111522;
23
- border: 1px solid rgba(255, 255, 255, 0.08);
24
- box-shadow: 0 4px 20px rgba(0, 0, 0, 0.25);
25
- }
26
- ```
@@ -1,201 +0,0 @@
1
- ---
2
- name: impeccable-design
3
- description: >
4
- Visual design quality enforcement. 50 deterministic anti-pattern rules preventing
5
- AI design slop. Bans generic fonts, pure colors, nested cards, dated animations.
6
- Adapted for Tailwind CSS v4, shadcn/ui, and Framer Motion stacks.
7
- ---
8
-
9
- # impeccable-design
10
-
11
- ## Overview
12
-
13
- Hard QA design review checklist consisting of 50 deterministic rules covering typography (T1-T10), color systems (C1-C12), layout constraints (L1-L11), component contracts (K1-K11), and micro-animations (A1-A8).
14
-
15
- ## When to Use
16
-
17
- Activate during the REVIEW phase of all frontend tasks as a strict visual and functional QA gate before marking UI work complete.
18
-
19
- ## Rules & Patterns
20
-
21
- Based on [pbakaus/impeccable](https://github.com/pbakaus/impeccable) — deterministic detector rules for AI-generated frontend design.
22
-
23
- ## Core Principle
24
-
25
- > Every model is trained on the same SaaS templates. Skip this guidance and you get the same handful of tells on every project. Impeccable eliminates them.
26
-
27
- ## Role in the Pipeline
28
-
29
- > **This skill acts as a QA-designer at the `/review` phase.** `ui-ux-pro` is the planning guideline; `impeccable-design` is the hard checklist that runs before merge.
30
-
31
- ---
32
-
33
- ## Anti-Pattern Rules
34
-
35
- ### Typography (Rules T1–T10)
36
-
37
- | Rule | Anti-Pattern | Correct Approach |
38
- | ------ | ------------- | ----------------- |
39
- | T1 | Using Inter for all text | Use Inter for UI body, pair with a distinct display font for headings OR with `JetBrains Mono` for technical/number accents (premium SaaS pattern) |
40
- | T2 | Using Arial or Helvetica | Use a curated Google Font pairing |
41
- | T3 | All text same weight | Use weight contrast: 700 headings, 400 body, 500 labels |
42
- | T4 | Line height = 1 (tight) | Body: 1.6–1.8, Headings: 1.1–1.3 |
43
- | T5 | No letter-spacing on caps | Uppercase labels: `letter-spacing: 0.08em` (Tailwind: `tracking-widest`) |
44
- | T6 | Text too wide | Max line length: 60–75 characters — use `max-w-prose` or `max-w-[65ch]` |
45
- | T7 | Monospace only for code | Use `tabular-nums` Tailwind class for number tables and data grids |
46
- | T8 | Random font sizing | Use a consistent modular scale (1.25× or 1.333×) — use Tailwind's `text-*` scale |
47
- | T9 | Body text too small | Minimum `text-sm` (14px) for body, never smaller than 12px |
48
- | T10 | Bold everywhere | Bold is for emphasis. Diluted if overused. |
49
-
50
- **Tailwind typography utilities:**
51
-
52
- - `text-balance` — for headlines (prevents orphan words)
53
- - `text-pretty` — for body paragraphs (smart line-breaks)
54
- - `tabular-nums` — for numerical data tables
55
-
56
- ### Color (Rules C1–C12)
57
-
58
- | Rule | Anti-Pattern | Correct Approach |
59
- | ------ | ------------- | ----------------- |
60
- | C1 | Pure black `#000` | Tint toward brand: `hsl(240, 10%, 4%)` |
61
- | C2 | Pure white `#fff` for surfaces | Near-white with warmth: `hsl(40, 30%, 97%)` |
62
- | C3 | Gray on colored background | Check contrast — likely fails WCAG. Use white/dark |
63
- | C4 | Purple → Blue gradient | Clichéd AI palette. Use brand-derived gradients |
64
- | C5 | Neon primary colors | Neon = accent only, never primary surface or text |
65
- | C6 | Too many colors | 3 colors max: primary, neutral, semantic (success/error) |
66
- | C7 | All links same blue `#0000EE` | Style links with brand color, preserve underline |
67
- | C8 | Disabled state = gray only | Disabled: `opacity-40` + `cursor-not-allowed` |
68
- | C9 | Success always green, Error always red | Check brand conflicts. Use accessible variants |
69
- | C10 | Dark mode = inverted light mode | Dark mode needs separate palette — use `@layer base { .dark { ... } }` |
70
- | C11 | No hover state change | Hover: shift lightness 8–12%, add `transition-colors duration-150` |
71
- | C12 | Brand color on dark surface loses identity | Adjust saturation/lightness for dark bg context |
72
-
73
- ### Layout & Spacing (Rules L1–L11)
74
-
75
- | Rule | Anti-Pattern | Correct Approach |
76
- | ------ | ------------- | ----------------- |
77
- | L1 | Cards inside cards | One level of card depth maximum |
78
- | L2 | Icon tile above every heading | Use icons inline, in context, not decoratively above text |
79
- | L3 | Centered long paragraphs | `text-center` max 2 lines only. Use `text-pretty` + left-align for body |
80
- | L4 | Inconsistent spacing | Use Tailwind spacing utilities only. **Never arbitrary values** like `gap-[17px]` |
81
- | L5 | Zero whitespace between sections | Sections need `py-16` to `py-24` breathing room |
82
- | L6 | Content touching edges | Always `px-4` minimum on mobile |
83
- | L7 | Same visual weight everywhere | Use hierarchy: primary > secondary > tertiary zones |
84
- | L8 | Grid breaks on tablet | Test at 768px. Use 4-col on tablet, 12-col on desktop |
85
- | L9 | Full-width everything | Max content width: `max-w-7xl` centered |
86
- | L10 | Missing grid alignment | Use CSS Grid or Tailwind `grid` — not absolute positioning |
87
- | L11 | Arbitrary high z-indexes | **NEVER** use `z-[999]` or `z-50` manually. Rely on DOM order + Radix/shadcn Portals which already handle modal elevation correctly |
88
- | L12 | Default Rhythm | Break the 'Hero → 3 Features → CTA' structure. Build structurally diverse pages tailored to the content. |
89
- | L13 | Symmetric card grids everywhere | Use asymmetric layouts (e.g., bento boxes, masonry, alternating left/right) to reduce the AI-generated feel. |
90
-
91
- ### Components (Rules K1–K11)
92
-
93
- | Rule | Anti-Pattern | Correct Approach |
94
- | ------ | ------------- | ----------------- |
95
- | K1 | Two filled buttons side-by-side | `<Button variant="default">` + `<Button variant="outline">` or `variant="ghost"` |
96
- | K2 | Button without loading state | Always add spinner + `disabled` during async actions |
97
- | K3 | Modal without backdrop blur | shadcn `<Dialog>` handles this. Don't override with plain divs |
98
- | K4 | Empty states left blank | **Always** design empty states: illustration + helpful message + primary CTA |
99
- | K5 | No skeleton screens | Use `<Skeleton>` from shadcn for content areas, not just spinners |
100
- | K6 | Tooltip on click (not hover) | Tooltips on hover, modals on click — use shadcn `<Tooltip>` + `<Dialog>` |
101
- | K7 | Dropdown without keyboard nav | Use shadcn `<DropdownMenu>` — keyboard nav is built-in |
102
- | K8 | Table without row hover | shadcn `<TableRow>` handles hover state automatically. Do **not** override it |
103
- | K9 | Building complex UI from scratch | **Check shadcn/ui first**. If the component exists, generate the CLI command: `npx shadcn@latest add dialog`. Never manually rewrite what shadcn already provides |
104
- | K10 | Native `<select>` or `<input type="date">` in premium UI | Native form controls cannot be styled consistently across Chrome/Safari/Firefox. Use `shadcn <Select>` and `shadcn <DatePicker>` for cross-browser consistency |
105
- | K11 | Form without error state styling | Every input must have error state: red border + error message below |
106
-
107
- ### Animation (Rules A1–A8)
108
-
109
- | Rule | Anti-Pattern | Correct Approach |
110
- | ------ | ------------- | ----------------- |
111
- | A1 | CSS bounce/elastic/spring easing | CSS spring animations are forbidden. **Exception**: If using Framer Motion, highly damped springs are encouraged: `{ type: "spring", stiffness: 400, damping: 30 }` for modals and popovers — this creates a premium, physical feel like Vercel/Linear |
112
- | A2 | Animations that take > 400ms | Micro: 100–150ms, Components: 200–300ms, Pages: 300–400ms |
113
- | A3 | Animations everywhere | Animate max 2–3 elements simultaneously |
114
- | A4 | Same animation for enter and exit | Enter: ease-out (decelerate), Exit: ease-in (accelerate) |
115
- | A5 | Animating expensive properties | Only animate `transform` and `opacity` — never `height`, `width`, `top` |
116
- | A6 | No animation on mobile | Respect `prefers-reduced-motion: reduce` — wrap in `@media` or use `useReducedMotion()` |
117
- | A7 | Scroll-triggered animations that block | Don't block content visibility for scroll reveals |
118
- | A8 | Hover animations on touch devices | Wrap hover effects in `@media (hover: hover)` |
119
-
120
- ### Images & Icons (Rules I1–I8)
121
-
122
- | Rule | Anti-Pattern | Correct Approach |
123
- | ------ | ------------- | ----------------- |
124
- | I1 | Decorative icons on every list item | Icons add meaning, not decoration. Use selectively. |
125
- | I2 | Mix of icon styles | Pick one icon set (e.g., Lucide for shadcn). Stick with it. |
126
- | I3 | Low-contrast icons | Icons need ≥ 3:1 contrast ratio |
127
- | I4 | Images without aspect-ratio | Always set `aspect-video` or `aspect-square` to prevent layout shifts |
128
- | I5 | No image loading state | Use `<Skeleton>` placeholder or blur hash |
129
- | I6 | SVG icons inline without aria | Add `aria-hidden="true"` or `aria-label` |
130
- | I7 | Stock photo generic humans | Use illustrations, abstract art, or genuine brand photography |
131
- | I8 | Unoptimized images | WebP/AVIF, properly sized, `loading="lazy"` below fold |
132
-
133
- ---
134
-
135
- ## Design Initialization Checklist
136
-
137
- Start every new design with:
138
-
139
- ```markdown
140
- ## Design Context
141
-
142
- **Surface type**: [brand/marketing OR product/app]
143
- **Target audience**: [who are they? what do they value?]
144
- **Brand tone**: [professional/playful/bold/minimal/technical]
145
- **Anti-references**: [designs this should NOT look like]
146
- **Primary font**: [chosen font + why + Framer Motion / shadcn pairing]
147
- **Color palette**: [3 semantic colors + HSL values for light AND dark]
148
- **Component library**: [shadcn/ui | radix | custom]
149
- **Animation library**: [CSS only | Framer Motion | GSAP]
150
- ```
151
-
152
- ---
153
-
154
- ## Design Review Audits
155
-
156
- ### Quick Audit (before PR)
157
-
158
- - Typography: Is there clear visual hierarchy? Are fonts intentional? Is Inter paired properly?
159
- - Color: Any pure black/white? Contrast failures? Too many colors? Dark mode?
160
- - Spacing: Consistent Tailwind scale? No arbitrary values? Enough whitespace?
161
- - Animation: Any CSS bounce/elastic? Too slow (>400ms)? Too many simultaneous?
162
- - Components: Any native `<select>` or `<input type="date">` that should be shadcn?
163
- - Z-index: Any hardcoded `z-[999]` or `z-50`?
164
-
165
- ### Full Audit (before release)
166
-
167
- - Accessibility: Run axe DevTools or Lighthouse — target 90+ score
168
- - Responsiveness: Test at 375px, 768px, 1280px, 1440px
169
- - Dark mode: Does the full palette hold up? No inverted-only shortcuts?
170
- - Empty states: Does every list/table have a designed empty state?
171
- - Edge cases: Loading states, error states, long text overflow, RTL
172
-
173
- ---
174
-
175
- ## Premium Design Markers
176
-
177
- These details separate premium from mediocre:
178
-
179
- 1. **Consistent border radius** — pick one and use it everywhere (`rounded-md` = 6px, `rounded-lg` = 8px)
180
- 2. **Intentional drop shadows** — darker near surface, lighter for floating elements
181
- 3. **Micro-copy quality** — button labels are verbs: "Save changes" not "Submit"
182
- 4. **Focus ring styling** — `focus-visible:ring-2 focus-visible:ring-primary` matching brand
183
- 5. **Smooth color transitions** — `transition-colors duration-150` on all interactive elements
184
- 6. **Optical alignment** — icon + text optically centered, not mathematically (`items-center gap-1.5`)
185
-
186
-
187
- ## Code Examples
188
-
189
- See `EXAMPLES.md` for detailed code examples.
190
-
191
- ## Validation Checklist
192
-
193
- What to verify during the review phase before completing the task.
194
-
195
- ## Common Mistakes
196
-
197
- Anti-patterns and things to explicitly avoid. See `TROUBLESHOOTING.md`.
198
-
199
- ## Integration Notes
200
-
201
- How this skill interacts with other skills.
@@ -1,19 +0,0 @@
1
- # impeccable-design Troubleshooting & Common Mistakes
2
-
3
- ## 1. Nested Border Radius Mismatch
4
-
5
- - **Symptom**: Corners of an inner element poke out or look visually awkward inside a container.
6
- - **Root Cause**: Using the same border-radius on both outer container and inner child.
7
- - **Fix**: Inner radius formula: r_inner = max(0, r_outer - padding).
8
-
9
- ## 2. Animation Performance Stutter
10
-
11
- - **Symptom**: Janky animations and dropped frames during transitions.
12
- - **Root Cause**: Animating layout properties (width, height, top, margin).
13
- - **Fix**: Animate only composited GPU-accelerated properties: transform and opacity.
14
-
15
- ## 3. Cluttered Visual Density
16
-
17
- - **Symptom**: Interface feels overwhelming, cramped, and cheap.
18
- - **Root Cause**: Cramming too many borders, dividers, badges, and icons into one view.
19
- - **Fix**: Replace borders with generous whitespace; let alignment and typography hierarchy define grouping.
@@ -1,12 +0,0 @@
1
- {
2
- "$schema": "http://json-schema.org/draft-07/schema#",
3
- "type": "object",
4
- "properties": {
5
- "rules_followed": {
6
- "type": "boolean"
7
- }
8
- },
9
- "required": [
10
- "rules_followed"
11
- ]
12
- }
@@ -1,14 +0,0 @@
1
- name: impeccable-design
2
- description: >
3
- Visual design quality skill based on pbakaus/impeccable.
4
- 46 deterministic anti-pattern rules that prevent AI design slop.
5
- Bans overused fonts, pure black/gray, nested cards, bounce animations,
6
- and all generic AI-generated design clichés.
7
- tags:
8
- - ui
9
- - design
10
- - frontend
11
- - visual
12
- - anti-patterns
13
- version: 1.0.0
14
- source: https://github.com/pbakaus/impeccable
@@ -1,97 +0,0 @@
1
- ---
2
- name: interview-me
3
- description: >
4
- Interactive requirements elicitation skill. Interrogates ambiguous, complex, or high-blast-radius
5
- tasks one focused question at a time before any plan or code is written.
6
- ---
7
-
8
- # interview-me
9
-
10
- ## Overview
11
-
12
- Structured requirements interrogation framework inspired by [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills). Prevents wasted cycles by transforming vague user intents into crisp, unambiguous architectural constraints through single-question progressive interview loops.
13
-
14
- ## When to Use
15
-
16
- Activate whenever:
17
-
18
- - User task has underspecified requirements, open UX decisions, or multiple viable architectural trade-offs.
19
- - A high-blast-radius change (database migrations, auth refactor, API contract change) is requested.
20
- - Explicitly triggered via `/spec`, `/interview`, or "ask me questions first".
21
-
22
- ## Rules & Patterns
23
-
24
- ### 1. The One-Question-At-A-Time Rule
25
-
26
- **Never overwhelm the user with a 10-point interrogation form.**
27
-
28
- - Ask **exactly ONE focused question** per turn (or at most two tightly-coupled binary options).
29
- - Provide the recommended option first with clear rationale: `"(Recommended) Option A because..."`.
30
- - Always allow write-in or clarification.
31
-
32
- ### 2. The 4 Interrogation Dimensions
33
-
34
- Interrogate in this strict priority order:
35
-
36
- 1. **Business Outcome & Invariants**:
37
- - What core problem does this solve?
38
- - What behavior is strictly forbidden?
39
- 2. **Scope Boundaries (In vs Out)**:
40
- - What must be delivered in this atomic slice?
41
- - What is explicitly deferred to later?
42
- 3. **Technical Constraints**:
43
- - Versions, libraries, database engines, backwards compatibility requirements.
44
- 4. **Edge Cases & Failure Modes**:
45
- - What happens on network disconnect, empty response, or unauthorized token?
46
-
47
- ### 3. Progressive Synthesis
48
-
49
- After each user answer:
50
-
51
- - Acknowledge the decision and update the mental model.
52
- - If more critical decisions remain, ask the next question.
53
- - Once 2–4 key questions are resolved, synthesize the formal Feature Spec and transition to `engineering-workflow` (`[PHASE: Plan]`).
54
-
55
- ---
56
-
57
- ## Code Examples
58
-
59
- ### Interactive Interview Turn Example
60
-
61
- ```markdown
62
- **Question 1 of 3 (Authentication Strategy)**
63
-
64
- Before implementing the API authentication layer, we need to align on session storage:
65
-
66
- 1. **(Recommended) HTTP-only Secure Cookies with Refresh Tokens**:
67
- - *Why*: Immune to XSS token theft, standard for web dashboards.
68
- 2. **Bearer Token in Authorization Header**:
69
- - *Why*: Ideal if this API will also be consumed by mobile apps or third-party CLI tools.
70
-
71
- Which model fits your architecture best?
72
- ```
73
-
74
- ---
75
-
76
- ## Validation Checklist
77
-
78
- - [ ] Question addresses an actual ambiguity (never ask about obvious defaults).
79
- - [ ] Exactly one question (or two tightly coupled choices) asked.
80
- - [ ] Recommendation provided with clear engineering justification.
81
- - [ ] User response incorporated into the final spec before coding.
82
-
83
- ---
84
-
85
- ## Common Mistakes
86
-
87
- - **Asking obvious questions**: Asking "Do you want error handling?" instead of making a sensible senior default.
88
- - **Interrogation bombardment**: Dumping a list of 8 open-ended questions in a single wall of text.
89
- - **Ignoring user answers**: Asking a question, receiving an answer, and then implementing something else.
90
-
91
- ---
92
-
93
- ## Integration Notes
94
-
95
- - Runs at the start of `engineering-workflow` Phase 1 (`/spec`).
96
- - Interacts with `gstack-roles` (`[ROLE: Product Manager]` or `[ROLE: Architect]`).
97
- - Hands off to `ponytail-mindset` once scope is defined.
@@ -1,12 +0,0 @@
1
- {
2
- "$schema": "http://json-schema.org/draft-07/schema#",
3
- "type": "object",
4
- "properties": {
5
- "rules_followed": {
6
- "type": "boolean"
7
- }
8
- },
9
- "required": [
10
- "rules_followed"
11
- ]
12
- }
@@ -1,8 +0,0 @@
1
- name: interview-me
2
- description: Interactive requirements elicitation skill. Interrogates ambiguous, complex, or high-blast-radius tasks one focused question at a time before any plan or code is written.
3
- tags:
4
- - workflow
5
- - requirements
6
- - planning
7
- - interview
8
- version: 1.0.0
@@ -1,38 +0,0 @@
1
- # microservices Examples — Anti-patterns vs ContextOS Standard
2
-
3
- ## Example 1: Inter-service Communication
4
-
5
- ### Anti-pattern: Synchronous HTTP Call Chains (The Distributed Monolith)
6
-
7
- ```text
8
- User -> OrderService (HTTP) -> InventoryService (HTTP) -> PaymentService (HTTP) -> EmailService (HTTP)
9
- Problem: High latency, 99.9% availability compounding to 96% overall availability, cascading failure.
10
- ```
11
-
12
- ### Best practice: ContextOS Standard (Asynchronous Event Choreography)
13
-
14
- ```text
15
- User -> OrderService (creates order with status 'PENDING')
16
- OrderService publishes 'OrderPlaced' event to Event Broker (Kafka/RabbitMQ)
17
- ├── InventoryService consumes 'OrderPlaced' -> Reserves stock
18
- ├── PaymentService consumes 'OrderPlaced' -> Charges customer
19
- └── NotificationService consumes 'PaymentProcessed' -> Sends confirmation email
20
- ```
21
-
22
- ---
23
-
24
- ## Example 2: Database Architecture
25
-
26
- ### Anti-pattern: Shared Database Across Multiple Microservices
27
-
28
- ```text
29
- BAD: OrderService and UserService both directly read and write to the same 'users' table.
30
- Schema migrations in UserService immediately break OrderService.
31
- ```
32
-
33
- ### Best practice: ContextOS Standard (Database-per-Service)
34
-
35
- ```text
36
- GOOD: UserService owns user data. OrderService maintains a local read-model (denormalized user info)
37
- synchronized via 'UserUpdated' events. Each service can migrate and scale independently.
38
- ```