nexakit 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (438) hide show
  1. package/.claude-plugin/marketplace.json +28 -0
  2. package/LICENSE +26 -0
  3. package/README.md +79 -2
  4. package/agents/claude/docs-researcher.md +9 -0
  5. package/agents/claude/implementation-tutor.md +9 -0
  6. package/agents/claude/project-explorer.md +9 -0
  7. package/agents/claude/quality-reviewer.md +9 -0
  8. package/agents/claude/requirements-analyst.md +9 -0
  9. package/agents/claude/solution-architect.md +9 -0
  10. package/agents/codex/docs-researcher.toml +10 -0
  11. package/agents/codex/implementation-tutor.toml +10 -0
  12. package/agents/codex/project-explorer.toml +10 -0
  13. package/agents/codex/quality-reviewer.toml +10 -0
  14. package/agents/codex/requirements-analyst.toml +11 -0
  15. package/agents/codex/solution-architect.toml +10 -0
  16. package/assets/brand/README.md +38 -0
  17. package/assets/brand/agent-toolkit-mark.png +0 -0
  18. package/assets/brand/agent-toolkit-mark.svg +13 -0
  19. package/assets/brand/agent-toolkit-tui-hero.png +0 -0
  20. package/assets/brand/nexakit-readme-hero.png +0 -0
  21. package/assets/brand/nexakit-readme-hero.svg +21 -0
  22. package/assets/runtime/package-lock.json +1425 -0
  23. package/bin/agent-task.js +14 -0
  24. package/bin/agent-toolkit-gemini.js +13 -0
  25. package/bin/agent-toolkit-inbox.js +14 -0
  26. package/bin/agent-toolkit-mcp.js +17 -0
  27. package/bin/agent-toolkit.js +13 -0
  28. package/bin/nexakit.js +13 -0
  29. package/bin/project-memory-mcp.js +22 -0
  30. package/bin/project-memory.js +7 -0
  31. package/catalogs/skills/api-design-principles/LICENSE.txt +21 -0
  32. package/catalogs/skills/api-design-principles/SKILL.md +110 -0
  33. package/catalogs/skills/api-design-principles/assets/api-design-checklist.md +155 -0
  34. package/catalogs/skills/api-design-principles/assets/rest-api-template.py +185 -0
  35. package/catalogs/skills/api-design-principles/references/details.md +413 -0
  36. package/catalogs/skills/api-design-principles/references/graphql-schema-design.md +589 -0
  37. package/catalogs/skills/api-design-principles/references/rest-best-practices.md +408 -0
  38. package/catalogs/skills/nodejs-backend-patterns/LICENSE.txt +21 -0
  39. package/catalogs/skills/nodejs-backend-patterns/SKILL.md +45 -0
  40. package/catalogs/skills/nodejs-backend-patterns/references/advanced-patterns.md +430 -0
  41. package/catalogs/skills/nodejs-backend-patterns/references/details.md +599 -0
  42. package/catalogs/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
  43. package/catalogs/skills/supabase-postgres-best-practices/LICENSE.txt +21 -0
  44. package/catalogs/skills/supabase-postgres-best-practices/SKILL.md +64 -0
  45. package/catalogs/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
  46. package/catalogs/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
  47. package/catalogs/skills/supabase-postgres-best-practices/references/_template.md +34 -0
  48. package/catalogs/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
  49. package/catalogs/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
  50. package/catalogs/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
  51. package/catalogs/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
  52. package/catalogs/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
  53. package/catalogs/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
  54. package/catalogs/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
  55. package/catalogs/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
  56. package/catalogs/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
  57. package/catalogs/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
  58. package/catalogs/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
  59. package/catalogs/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
  60. package/catalogs/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
  61. package/catalogs/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
  62. package/catalogs/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
  63. package/catalogs/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
  64. package/catalogs/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
  65. package/catalogs/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
  66. package/catalogs/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
  67. package/catalogs/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
  68. package/catalogs/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
  69. package/catalogs/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
  70. package/catalogs/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
  71. package/catalogs/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
  72. package/catalogs/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
  73. package/catalogs/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
  74. package/catalogs/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
  75. package/catalogs/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
  76. package/catalogs/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
  77. package/catalogs/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
  78. package/catalogs/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
  79. package/catalogs/skills/vercel-composition-patterns/AGENTS.md +946 -0
  80. package/catalogs/skills/vercel-composition-patterns/LICENSE.txt +27 -0
  81. package/catalogs/skills/vercel-composition-patterns/README.md +60 -0
  82. package/catalogs/skills/vercel-composition-patterns/SKILL.md +89 -0
  83. package/catalogs/skills/vercel-composition-patterns/metadata.json +11 -0
  84. package/catalogs/skills/vercel-composition-patterns/rules/_sections.md +29 -0
  85. package/catalogs/skills/vercel-composition-patterns/rules/_template.md +24 -0
  86. package/catalogs/skills/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
  87. package/catalogs/skills/vercel-composition-patterns/rules/architecture-compound-components.md +112 -0
  88. package/catalogs/skills/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -0
  89. package/catalogs/skills/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -0
  90. package/catalogs/skills/vercel-composition-patterns/rules/react19-no-forwardref.md +42 -0
  91. package/catalogs/skills/vercel-composition-patterns/rules/state-context-interface.md +191 -0
  92. package/catalogs/skills/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -0
  93. package/catalogs/skills/vercel-composition-patterns/rules/state-lift-state.md +125 -0
  94. package/catalogs/skills/vercel-react-best-practices/AGENTS.md +3810 -0
  95. package/catalogs/skills/vercel-react-best-practices/LICENSE.txt +27 -0
  96. package/catalogs/skills/vercel-react-best-practices/README.md +123 -0
  97. package/catalogs/skills/vercel-react-best-practices/SKILL.md +149 -0
  98. package/catalogs/skills/vercel-react-best-practices/metadata.json +15 -0
  99. package/catalogs/skills/vercel-react-best-practices/rules/_sections.md +46 -0
  100. package/catalogs/skills/vercel-react-best-practices/rules/_template.md +28 -0
  101. package/catalogs/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  102. package/catalogs/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  103. package/catalogs/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  104. package/catalogs/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  105. package/catalogs/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  106. package/catalogs/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  107. package/catalogs/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
  108. package/catalogs/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  109. package/catalogs/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
  110. package/catalogs/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  111. package/catalogs/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
  112. package/catalogs/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
  113. package/catalogs/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  114. package/catalogs/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  115. package/catalogs/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  116. package/catalogs/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  117. package/catalogs/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  118. package/catalogs/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  119. package/catalogs/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  120. package/catalogs/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  121. package/catalogs/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  122. package/catalogs/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  123. package/catalogs/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  124. package/catalogs/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  125. package/catalogs/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  126. package/catalogs/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  127. package/catalogs/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
  128. package/catalogs/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  129. package/catalogs/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  130. package/catalogs/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  131. package/catalogs/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  132. package/catalogs/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
  133. package/catalogs/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  134. package/catalogs/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  135. package/catalogs/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  136. package/catalogs/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  137. package/catalogs/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  138. package/catalogs/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  139. package/catalogs/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  140. package/catalogs/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  141. package/catalogs/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  142. package/catalogs/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
  143. package/catalogs/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
  144. package/catalogs/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  145. package/catalogs/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  146. package/catalogs/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  147. package/catalogs/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  148. package/catalogs/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  149. package/catalogs/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  150. package/catalogs/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  151. package/catalogs/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  152. package/catalogs/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  153. package/catalogs/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  154. package/catalogs/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  155. package/catalogs/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
  156. package/catalogs/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  157. package/catalogs/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  158. package/catalogs/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  159. package/catalogs/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  160. package/catalogs/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  161. package/catalogs/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  162. package/catalogs/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  163. package/catalogs/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  164. package/catalogs/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  165. package/catalogs/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  166. package/catalogs/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
  167. package/catalogs/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
  168. package/catalogs/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  169. package/catalogs/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  170. package/catalogs/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
  171. package/catalogs/skills/webapp-testing/LICENSE.txt +202 -0
  172. package/catalogs/skills/webapp-testing/SKILL.md +96 -0
  173. package/catalogs/skills/webapp-testing/examples/console_logging.py +35 -0
  174. package/catalogs/skills/webapp-testing/examples/element_discovery.py +40 -0
  175. package/catalogs/skills/webapp-testing/examples/static_html_automation.py +33 -0
  176. package/catalogs/skills/webapp-testing/scripts/with_server.py +106 -0
  177. package/catalogs/skills.json +1115 -0
  178. package/docs/skills/evidencias/2026-10-28-evaluacion-inicial-mcp-seguridad.md +118 -0
  179. package/docs/skills/evidencias/2026-10-28-incorporacion-mcp-seguridad.json +152 -0
  180. package/docs/skills/evidencias/2026-10-28-recomendador-preparacion.md +50 -0
  181. package/package.json +73 -4
  182. package/plugins/nexakit-modelo/.claude-plugin/plugin.json +1 -0
  183. package/plugins/nexakit-modelo/hooks/hooks.json +1 -0
  184. package/plugins/nexakit-modelo/hooks/register.js +48 -0
  185. package/plugins/nexakit-modelo/hooks/status.js +8 -0
  186. package/plugins/nexakit-modelo/tests/register.test.ts +21 -0
  187. package/plugins/nexakit-panel/.claude-plugin/plugin.json +1 -0
  188. package/plugins/nexakit-panel/README.md +20 -0
  189. package/plugins/nexakit-panel/hooks/hooks.json +1 -0
  190. package/plugins/nexakit-panel/hooks/lienzo.js +382 -0
  191. package/plugins/nexakit-panel/hooks/panel.js +279 -0
  192. package/plugins/nexakit-panel/hooks/register.tsx +248 -0
  193. package/plugins/nexakit-panel/tests/lienzo.test.ts +142 -0
  194. package/plugins/nexakit-panel/tests/panel.test.ts +240 -0
  195. package/plugins/nexakit-panel/tests/register.test.ts +167 -0
  196. package/plugins/nexakit-panel/types/index.d.ts +41 -0
  197. package/plugins/nexakit-sesion/.claude-plugin/plugin.json +1 -0
  198. package/plugins/nexakit-sesion/README.md +12 -0
  199. package/plugins/nexakit-sesion/hooks/aviso.js +38 -0
  200. package/plugins/nexakit-sesion/hooks/hooks.json +1 -0
  201. package/plugins/nexakit-sesion/hooks/register.js +28 -0
  202. package/plugins/nexakit-sesion/tests/register.test.ts +96 -0
  203. package/plugins/niveles/.claude-plugin/plugin.json +5 -0
  204. package/plugins/niveles/agents/nivel-alto.md +13 -0
  205. package/plugins/niveles/agents/nivel-exigente.md +13 -0
  206. package/plugins/niveles/agents/nivel-ligero.md +13 -0
  207. package/plugins/niveles/agents/nivel-normal.md +13 -0
  208. package/schemas/agent-client-adapter.schema.json +786 -0
  209. package/schemas/agent-client-auth-diagnostic.schema.json +801 -0
  210. package/schemas/agent-client-isolated-variant.schema.json +105 -0
  211. package/schemas/agent-client-isolated-verification.schema.json +99 -0
  212. package/schemas/agent-client-managed-preferences-invocation.schema.json +67 -0
  213. package/schemas/agent-client-managed-preferences.schema.json +63 -0
  214. package/schemas/agent-client-native-diagnostics.schema.json +85 -0
  215. package/schemas/agent-client-native-evaluation.schema.json +171 -0
  216. package/schemas/agent-client-native-preflight.schema.json +90 -0
  217. package/schemas/agent-client-output.schema.json +551 -0
  218. package/schemas/agent-client-runtime-fixture.schema.json +90 -0
  219. package/schemas/agent-client-runtime-local.schema.json +95 -0
  220. package/schemas/agent-client-runtime.schema.json +1288 -0
  221. package/schemas/agent-client-selective-config.schema.json +77 -0
  222. package/schemas/agent-client-supervised-local.schema.json +135 -0
  223. package/schemas/agent-client-supervised.schema.json +186 -0
  224. package/schemas/agent-model-preference.schema.json +573 -0
  225. package/schemas/agent-model-selection.schema.json +311 -0
  226. package/schemas/agent-task-approvals.schema.json +362 -0
  227. package/schemas/agent-task-prepare.schema.json +1324 -0
  228. package/schemas/agent-task-verify.schema.json +198 -0
  229. package/schemas/project-memory-update.schema.json +33 -0
  230. package/schemas/project-memory.schema.json +298 -0
  231. package/schemas/skill-catalog.schema.json +246 -0
  232. package/schemas/task-workflow-plan-output.schema.json +35 -0
  233. package/scripts/prepare-package.js +6 -0
  234. package/scripts/validate-skill-catalog.js +41 -0
  235. package/skills/cerrar-avisens/SKILL.md +12 -0
  236. package/skills/cerrar-memoria/SKILL.md +96 -0
  237. package/skills/cerrar-memoria/references/cierre.md +76 -0
  238. package/skills/decision-records/SKILL.md +27 -0
  239. package/skills/decision-records/agents/openai.yaml +7 -0
  240. package/skills/decision-records/references/adr-template.md +35 -0
  241. package/skills/differential-review/LICENSE.txt +427 -0
  242. package/skills/differential-review/SKILL.md +225 -0
  243. package/skills/differential-review/adversarial.md +203 -0
  244. package/skills/differential-review/agents/openai.yaml +6 -0
  245. package/skills/differential-review/assets/trail-of-bits-mark.svg +1 -0
  246. package/skills/differential-review/methodology.md +234 -0
  247. package/skills/differential-review/patterns.md +300 -0
  248. package/skills/differential-review/reporting.md +369 -0
  249. package/skills/elegir-modelo/SKILL.md +68 -0
  250. package/skills/elegir-modelo/modelos.mjs +108 -0
  251. package/skills/frontend-design/LICENSE.txt +177 -0
  252. package/skills/frontend-design/SKILL.md +71 -0
  253. package/skills/gemini/SKILL.md +52 -0
  254. package/skills/imagen/SKILL.md +12 -0
  255. package/skills/investigar/SKILL.md +11 -0
  256. package/skills/mcp-builder/LICENSE.txt +202 -0
  257. package/skills/mcp-builder/SKILL.md +236 -0
  258. package/skills/mcp-builder/reference/evaluation.md +602 -0
  259. package/skills/mcp-builder/reference/mcp_best_practices.md +249 -0
  260. package/skills/mcp-builder/reference/node_mcp_server.md +970 -0
  261. package/skills/mcp-builder/reference/python_mcp_server.md +719 -0
  262. package/skills/mcp-builder/scripts/connections.py +151 -0
  263. package/skills/mcp-builder/scripts/evaluation.py +373 -0
  264. package/skills/mcp-builder/scripts/example_evaluation.xml +22 -0
  265. package/skills/mcp-builder/scripts/requirements.txt +2 -0
  266. package/skills/ordenar-proyecto/SKILL.md +56 -0
  267. package/skills/project-handoff/SKILL.md +53 -0
  268. package/skills/project-handoff/agents/openai.yaml +7 -0
  269. package/skills/project-handoff/references/handoff-template.md +35 -0
  270. package/skills/quality-gate/LICENSE.txt +26 -0
  271. package/skills/quality-gate/SKILL.md +44 -0
  272. package/skills/quality-gate/agents/openai.yaml +7 -0
  273. package/skills/quality-gate/references/review-checklist.md +42 -0
  274. package/skills/revisar/SKILL.md +11 -0
  275. package/skills/revisar-skill/LICENSE-find-skills.txt +26 -0
  276. package/skills/revisar-skill/SKILL.md +94 -0
  277. package/skills/revision-cruzada/SKILL.md +59 -0
  278. package/skills/web-design-guidelines/AGENTS.md +156 -0
  279. package/skills/web-design-guidelines/LICENSE.txt +21 -0
  280. package/skills/web-design-guidelines/SKILL.md +29 -0
  281. package/src/agent-models.js +131 -0
  282. package/src/brand.js +117 -0
  283. package/src/claude-code-runner.js +642 -0
  284. package/src/cli-executable.js +88 -0
  285. package/src/cli.js +778 -0
  286. package/src/client-adapter-plan.js +271 -0
  287. package/src/client-auth-diagnostic-parser.js +211 -0
  288. package/src/client-auth-diagnostic.js +257 -0
  289. package/src/client-isolated-variant.js +106 -0
  290. package/src/client-isolated-verification.js +130 -0
  291. package/src/client-local-platform.js +14 -0
  292. package/src/client-managed-preferences-invocation.js +209 -0
  293. package/src/client-managed-preferences.js +78 -0
  294. package/src/client-native-access.js +134 -0
  295. package/src/client-native-diagnostics.js +253 -0
  296. package/src/client-native-evaluation.js +106 -0
  297. package/src/client-native-preflight-files.js +68 -0
  298. package/src/client-native-preflight.js +95 -0
  299. package/src/client-output-json.js +118 -0
  300. package/src/client-output-parser.js +278 -0
  301. package/src/client-runtime-admission.js +80 -0
  302. package/src/client-runtime-coordinator.js +70 -0
  303. package/src/client-runtime-core.js +92 -0
  304. package/src/client-runtime-fixture-permit.js +20 -0
  305. package/src/client-runtime-fixture-protocol.js +39 -0
  306. package/src/client-runtime-state.js +67 -0
  307. package/src/client-runtime-store-files.js +91 -0
  308. package/src/client-runtime-store.js +239 -0
  309. package/src/client-runtime-supervisor.js +146 -0
  310. package/src/client-selective-config.js +195 -0
  311. package/src/client-selective-files.js +126 -0
  312. package/src/client-supervised-codes.js +32 -0
  313. package/src/client-supervised-contract.js +52 -0
  314. package/src/client-supervised-coordinator.js +36 -0
  315. package/src/client-supervised-permit.js +20 -0
  316. package/src/client-supervised-protocol.js +37 -0
  317. package/src/client-supervised-store.js +167 -0
  318. package/src/client-supervised-supervisor.js +167 -0
  319. package/src/client-supervised.js +160 -0
  320. package/src/codex-cli-runner.js +358 -0
  321. package/src/codex-delivery.js +101 -0
  322. package/src/connect.js +703 -0
  323. package/src/doctor.js +795 -0
  324. package/src/gemini-cli.js +76 -0
  325. package/src/gemini-files.js +45 -0
  326. package/src/gemini-tools.js +249 -0
  327. package/src/init.js +473 -0
  328. package/src/install-lock.js +127 -0
  329. package/src/install-registry.js +61 -0
  330. package/src/legacy-repair.js +71 -0
  331. package/src/level-agents.js +111 -0
  332. package/src/link-states.js +172 -0
  333. package/src/memory-connection-artifacts.js +192 -0
  334. package/src/memory-connection-descriptor.js +158 -0
  335. package/src/memory-connection-diagnostic.js +177 -0
  336. package/src/memory-connection-files.js +191 -0
  337. package/src/memory-connection-manifest.js +118 -0
  338. package/src/memory-connection-package.js +176 -0
  339. package/src/memory-connection-plan.js +211 -0
  340. package/src/memory-connection-skill.js +211 -0
  341. package/src/memory-connection-toml.js +153 -0
  342. package/src/memory-locator.js +118 -0
  343. package/src/memory-mcp-policy.js +181 -0
  344. package/src/memory-mcp-server.js +166 -0
  345. package/src/memory-mcp-transport.js +59 -0
  346. package/src/missing-dependencies.js +21 -0
  347. package/src/model-command.js +147 -0
  348. package/src/model-preference.js +235 -0
  349. package/src/model-selection.js +368 -0
  350. package/src/native/managed-preferences.c +100 -0
  351. package/src/native/managed-preferences.h +17 -0
  352. package/src/package-lock-path.js +13 -0
  353. package/src/panel-cli.js +182 -0
  354. package/src/peer-handoff.js +27 -0
  355. package/src/peer-inbox-cli.js +211 -0
  356. package/src/peer-review-mcp.js +210 -0
  357. package/src/peer-review-store.js +532 -0
  358. package/src/platform.js +24 -0
  359. package/src/project-root.js +41 -0
  360. package/src/project-signals.js +339 -0
  361. package/src/recommend-report.js +77 -0
  362. package/src/review-instructions.js +211 -0
  363. package/src/review-policy.js +35 -0
  364. package/src/revision-adapters.js +157 -0
  365. package/src/revision-context.js +86 -0
  366. package/src/revision-isolation.js +222 -0
  367. package/src/revision-process.js +103 -0
  368. package/src/revision-provenance.js +89 -0
  369. package/src/revision-snapshot.js +120 -0
  370. package/src/revision.js +242 -0
  371. package/src/runtime-fixtures/runtime-supervisor/child.cjs +3 -0
  372. package/src/runtime-fixtures/runtime-supervisor/fixture.cjs +49 -0
  373. package/src/runtime-fixtures/supervised/child.cjs +3 -0
  374. package/src/runtime-fixtures/supervised/fixture.cjs +47 -0
  375. package/src/sensitive-data.js +21 -0
  376. package/src/setup-apply.js +231 -0
  377. package/src/setup-plan.js +231 -0
  378. package/src/setup-state.js +277 -0
  379. package/src/setup-tui.js +555 -0
  380. package/src/skill-catalog-add.js +91 -0
  381. package/src/skill-catalog-audit.js +68 -0
  382. package/src/skill-catalog.js +170 -0
  383. package/src/skill-files.js +39 -0
  384. package/src/skill-recommendations.js +1673 -0
  385. package/src/skill-scan-report.js +14 -0
  386. package/src/skill-scan.js +178 -0
  387. package/src/stable-command.js +53 -0
  388. package/src/stable-install.js +222 -0
  389. package/src/status.js +200 -0
  390. package/src/superpowers.js +133 -0
  391. package/src/sync-apply.js +227 -0
  392. package/src/sync-files.js +109 -0
  393. package/src/sync-inspect.js +394 -0
  394. package/src/sync-ledger.js +94 -0
  395. package/src/sync-markdown.js +151 -0
  396. package/src/sync-proposal.js +84 -0
  397. package/src/sync-record.js +459 -0
  398. package/src/sync.js +360 -0
  399. package/src/task-approvals.js +367 -0
  400. package/src/task-cli.js +79 -0
  401. package/src/task-external-verifier.js +584 -0
  402. package/src/task-prepare-files.js +115 -0
  403. package/src/task-prepare.js +180 -0
  404. package/src/task-verify-cli.js +67 -0
  405. package/src/task-verify-files.js +188 -0
  406. package/src/task-verify.js +118 -0
  407. package/src/task-workflow-mcp.js +544 -0
  408. package/src/task-workflow-store.js +254 -0
  409. package/src/terminal-text.js +68 -0
  410. package/src/toolkit-cli.js +543 -0
  411. package/src/toolkit-commands-guide.js +107 -0
  412. package/src/toolkit-setup.js +614 -0
  413. package/src/usage-metrics.js +43 -0
  414. package/templates/agent-team/01-encargo.md +158 -0
  415. package/templates/agent-team/02-propuesta.md +132 -0
  416. package/templates/agent-team/03-revision.md +150 -0
  417. package/templates/agent-team/README.md +213 -0
  418. package/templates/model-inventory/01-inventario.md +154 -0
  419. package/templates/model-inventory/README.md +115 -0
  420. package/templates/project-memory/README.md +67 -0
  421. package/templates/project-memory/project-memory.example.json +53 -0
  422. package/templates/project-memory/skill/project-id/SKILL.md +37 -0
  423. package/templates/project-memory/skill/project-id/references/project-profile.md +44 -0
  424. package/templates/project-memory/vault/00-INICIO/Estado actual.md +44 -0
  425. package/templates/project-memory/vault/00-INICIO/Fuentes de verdad.md +30 -0
  426. package/templates/project-memory/vault/00-INICIO/Inicio del proyecto.md +44 -0
  427. package/templates/project-memory/vault/00-INICIO/Mantenimiento de la memoria.md +26 -0
  428. package/templates/project-memory/vault/00-INICIO/Mapa de la memoria.md +33 -0
  429. package/templates/project-memory/vault/00-INICIO/Registro de sincronizaci/303/263n.md" +28 -0
  430. package/templates/project-memory/vault/01-PRODUCTO/Producto.md +16 -0
  431. package/templates/project-memory/vault/02-ARQUITECTURA/Arquitectura.md +16 -0
  432. package/templates/project-memory/vault/03-IMPLEMENTACION/Implementaci/303/263n.md +15 -0
  433. package/templates/project-memory/vault/04-DECISIONES/Decisiones.md +19 -0
  434. package/templates/project-memory/vault/05-ENTREGAS/Entregas.md +12 -0
  435. package/templates/project-memory/vault/06-OPERACION/Operaci/303/263n.md +15 -0
  436. package/templates/project-memory/vault/07-AGENTES/Protocolo de agentes.md +33 -0
  437. package/templates/project-memory/vault/08-RECURSOS/Recursos.md +12 -0
  438. package/templates/project-memory/vault/09-ARCHIVO/README.md +5 -0
@@ -0,0 +1,154 @@
1
+ # Inventario: [cliente y revisión]
2
+
3
+ Formulario genérico, no inventario activo ni configuración. Completar una copia
4
+ privada solo después de autorizar su ruta y recogida. Los campos entre corchetes
5
+ son pendientes, no valores válidos de un JSON. No incluir credenciales, email,
6
+ nombre legal, ID de cuenta, conversaciones o salidas extensas.
7
+
8
+ ## 1. Identidad y alcance autorizado
9
+
10
+ - inventoryId: [identificador local sin datos personales]
11
+ - revision: [r01 o revisión nueva, sin sobrescribir la anterior]
12
+ - previousInventory: [referencia y huella de bytes / ninguno comprobado]
13
+ - status: draft
14
+ - recordedAt: [instante UTC real de redacción / pendiente]
15
+ - recorder: [rol que registra, sin datos personales]
16
+ - collectionAuthorization: [instrucción directa del usuario y alcance / pendiente]
17
+ - privateDestinationApproved: [ruta acordada de la copia privada / pendiente]
18
+ - sharingScope: [destinatario y datos expresamente permitidos / no autorizado]
19
+ - allowedInspection: [fuentes y acciones concretas aprobadas / pendiente]
20
+ - excludedActions: inferencias, cambios de modelo o configuración, autenticación,
21
+ instalación, publicación y lectura de almacenes de credenciales.
22
+
23
+ El formulario no acredita permisos. El receptor comprueba la autorización en su
24
+ sesión; sin ella no recoge ni guarda datos. La aprobación de una plantilla no
25
+ autoriza un inventario real. El piloto anterior permanece intacto.
26
+
27
+ ## 2. Cliente y procedencia
28
+
29
+ - clientName: [nombre observado / no confirmado]
30
+ - clientVariant: [oficial / wrapper / otra variante / no identificada]
31
+ - surface: [CLI / extensión / aplicación / pendiente]
32
+ - provider: [proveedor identificado para este registro / pendiente]
33
+ - versionObserved: [versión realmente observada / no confirmada]
34
+ - versionEvidenceRef: [ID de evidencia de sección 3 / pendiente]
35
+ - identificationLimitations: [límites o contradicciones / ninguna tras comprobar]
36
+ - officialDocumentationRef: [fuente pertinente a la variante y versión / pendiente]
37
+ - inspectionMethodReviewed: [método no mutante delimitado y fuente / pendiente]
38
+
39
+ Un nombre o una ruta no certifica procedencia. No ejecutar un cliente desconocido
40
+ para identificarlo ni asumir comandos del CLI estándar para un wrapper. Si no
41
+ hay método seguro, solicitar una observación manual acotada. No arrancar sesiones,
42
+ hooks, actualizaciones ni carga de contexto del proyecto para hacer el inventario.
43
+
44
+ ## 3. Registro mínimo de evidencia
45
+
46
+ Repetir una fila por observación, conservando datos contradictorios separados.
47
+ La fecha corresponde a la observación original, no al momento de copiarla.
48
+
49
+ | evidenceId | Tipo de fuente | ObservedAt UTC | Referencia privada o URL oficial | Alcance y resumen mínimo | Limitaciones |
50
+ | --- | --- | --- | --- | --- | --- |
51
+ | [ID local] | [documentación / menú / declaración del usuario / metadata del cliente] | [AAAA-MM-DDTHH:MM:SSZ / pendiente] | [referencia segura / pendiente] | [qué se observó, sin datos de cuenta] | [versión, vigencia o incertidumbre] |
52
+
53
+ Por defecto conservar resumen y referencia, no capturas completas. Recortar y
54
+ ocultar datos privados antes de guardar o compartir una captura autorizada.
55
+ No copiar logs, variables de entorno o archivos de autenticación. Una referencia
56
+ o hash no convierte una declaración en prueba independiente ni anonimiza datos.
57
+
58
+ ## 4. Modelo observado — repetir un bloque por opción
59
+
60
+ Este bloque separa oferta, acceso y evaluación. Que aparezca en un menú no implica
61
+ que esté disponible ni aprobado para una tarea. No completar nombres por intuición.
62
+
63
+ ### Opción: [etiqueta observada / pendiente]
64
+
65
+ - observationId: [ID local único]
66
+ - clientEvidenceRef: [identificación de sección 2 / pendiente]
67
+ - displayLabel: [etiqueta exacta observada / pendiente]
68
+ - offeredEvidenceRef: [ID de evidencia / pendiente]
69
+ - requestedModel: [identificador documentado para solicitarlo / no confirmado]
70
+ - identifierEvidenceRef: [fuente del identificador / pendiente]
71
+ - versionKind: [versión concreta / alias / automático / no confirmado]
72
+ - aliasResolution: [resolución y evidencia / desconocida / no aplica]
73
+ - effortOptionsObserved: [opciones documentadas con referencias / desconocidas]
74
+ - additionalRestrictions: [restricciones visibles / desconocidas]
75
+
76
+ ### 4A. Disponibilidad declarada de cuenta
77
+
78
+ - availabilityStatus: unknown
79
+ - checkedAt: [fecha UTC de la evidencia original / pendiente]
80
+ - provenance: [user-declaration / client-metadata / pendiente]
81
+ - availabilityEvidenceRef: [evidencia concreta relativa al acceso / pendiente]
82
+ - availabilityScope: [alcance de declaración o metadata / desconocido]
83
+ - contradictoryEvidenceRefs: [IDs separados / ninguna tras comprobar]
84
+ - contradictionResolution: [decisión humana y evidencia / pendiente / no aplica]
85
+ - agePolicy: [availabilityMaxAgeSeconds aprobado / pendiente]
86
+ - ageCheck: [vigente / caducada / futura / pendiente]
87
+
88
+ Estados posibles: `available`, `unavailable`, `unknown`. Un menú genérico deja
89
+ acceso `unknown`; no es metadata específica de disponibilidad. Una declaración
90
+ explícita se conserva como `user-declaration`, nunca como inferencia verificada.
91
+ Ante contradicción, no escoger a ciegas: conservar ambas fuentes, bloquear la
92
+ conversión del dato disputado y pedir resolución humana. No renovar `checkedAt`
93
+ al copiar ni sustituir una fecha futura para pasar la política de vigencia.
94
+
95
+ ### 4B. Capacidades declaradas y evaluación pendiente
96
+
97
+ - candidateStatus: candidate
98
+ - proposedRoles: [roles a evaluar / pendientes; no aprobados]
99
+ - declaredCapabilities: [herramientas, modalidades, formatos y contexto, con fuentes / desconocidas]
100
+ - verifiedCapabilities: [solo comprobadas con evidencia / ninguna comprobada]
101
+ - verifiedContextTokens: [cantidad respaldada por evidencia / desconocido]
102
+ - roleEvaluationRefs: [evaluaciones autorizadas anteriores pertinentes / ninguna comprobada]
103
+ - approvalForRole: pendiente; no se concede con el inventario.
104
+
105
+ No copiar capacidades declaradas a verificadas. En una conversión futura,
106
+ listas verificadas vacías y contexto `null` pueden representar falta de evidencia,
107
+ no incapacidad ni contexto ilimitado. No inventar fuentes o evaluaciones para
108
+ crear JSON. El nombre de una familia no justifica prioridades entre proveedores.
109
+ Un modelo nuevo queda como `candidate`; evaluar tutoría no aprueba aplicación.
110
+
111
+ ### 4C. Consumo y límites del cliente
112
+
113
+ - accessTypeObserved: [sesión de cuenta / otro / desconocido, con evidencia segura]
114
+ - consumptionType: [incluido en plan declarado / crédito adicional / facturación API / desconocido]
115
+ - consumptionEvidenceRef: [ID de evidencia / pendiente]
116
+ - quotaVisibility: [límite observado y referencia / desconocida]
117
+ - selectionSideEffects: [persistencia de default u otros efectos documentados / desconocidos]
118
+ - routingAndFallback: [comportamiento documentado y referencia / desconocido]
119
+ - auxiliaryModels: [lo que informa/controla el cliente / desconocido]
120
+ - requestedVsObservedLimitations: [observabilidad por ejecución / desconocida]
121
+ - nextSafeAction: [resolver un dato / revisión documental; ninguna llamada por defecto]
122
+
123
+ `session-account` no demuestra que el modelo esté incluido en el plan. Consumo
124
+ desconocido o facturación adicional bloquean la futura inferencia hasta resolverlo;
125
+ no activar créditos, API, otra autenticación o proveedor para continuar.
126
+ Inspeccionar no significa seleccionar: no confirmar filas del menú ni persistir
127
+ defaults. Cuota, alias, auxiliares o fallback opacos se registran como límites,
128
+ sin reintentos ni promesa de compatibilidad estricta. No desactivar protecciones.
129
+
130
+ ## 5. Revisión y siguiente puerta
131
+
132
+ - reviewer: [rol que contrasta]
133
+ - reviewedAt: [instante UTC de revisión / pendiente]
134
+ - evidenceIndependentlyChecked: [IDs y alcance contrastado / ninguna]
135
+ - evidenceReceivedOnly: [IDs recibidos sin comprobar de forma independiente / ninguna]
136
+ - unresolvedInformation: [datos faltantes y contradicciones / ninguna tras comprobar]
137
+ - privacyAndScopeCheck: [resultado / pendiente]
138
+ - documentaryDisposition: [borrador / listo para revisión / bloqueado / revisado]
139
+ - proposedNextAction: [recogida delimitada / evaluación a proponer / pendiente]
140
+ - realCatalogOrPolicyWritten: no autorizado por este formulario.
141
+ - inferences: no autorizadas por esta recogida.
142
+ - commitPushMemoryChanges: no autorizados por este formulario.
143
+
144
+ La revisión no demuestra el modelo de una respuesta que no se ejecutó. No llenar
145
+ `observedModels` ni `verified` de una entrega con nombres del menú. La conversión
146
+ posterior a catálogo/política/solicitud necesita autorización y validación del
147
+ contrato existente: `availability` va en la solicitud privada, no en el catálogo.
148
+ Sin identificador o fuente válida, mantener borrador; sin perfiles válidos,
149
+ no fabricar un catálogo vacío. Ninguna selección ejecuta por sí sola un modelo.
150
+
151
+ Una nueva observación crea una nueva revisión con su fecha, sin sobrescribir
152
+ evidencias anteriores. No concede permiso para cambiar de modo, iniciar pruebas
153
+ o compartir datos nuevos. Guardar esta copia real fuera de biblioteca, Obsidian,
154
+ Git y carpetas sincronizadas, en la ruta previamente acordada.
@@ -0,0 +1,115 @@
1
+ # Inventario de clientes y modelos
2
+
3
+ Esta base ayuda a saber qué cliente usas, qué modelos muestra y qué información
4
+ falta antes de elegir uno para una tarea. No descubre modelos automáticamente,
5
+ accede a cuentas, realiza llamadas de IA ni cambia configuraciones.
6
+
7
+ Contrato: [especificación del inventario](../../docs/agentes/modelos/agent-model-inventory.md).
8
+ Plantilla: [01-inventario.md](01-inventario.md).
9
+
10
+ ## Tres cosas que no deben confundirse
11
+
12
+ | Pregunta | Qué registrar | Qué no asumir |
13
+ | --- | --- | --- |
14
+ | ¿El cliente muestra el modelo? | Etiqueta, versión/variante y fuente | Que tu cuenta pueda usarlo |
15
+ | ¿La cuenta tiene acceso declarado? | Estado, fecha, procedencia y alcance | Que cada llamada será aceptada o estará incluida en el plan |
16
+ | ¿Sirve para esta tarea? | Evaluación autorizada por rol y criterios | Que aparecer en el menú lo aprueba para escribir código |
17
+
18
+ Estas plantillas son formularios Markdown, no los JSON del selector. Los
19
+ corchetes y datos pendientes no son valores para alimentar una configuración.
20
+ Un inventario puede estar incompleto sin inventar permisos, modelos o fechas.
21
+
22
+ ## Cómo se recogería un inventario real
23
+
24
+ 1. Acordar un solo cliente y la ruta privada de destino, fuera de Agent-Toolkit,
25
+ Obsidian, Git y sincronización. Autorizar fuentes y acciones mínimas de recogida.
26
+ La carpeta del piloto anterior no se reutiliza por permiso implícito.
27
+ 2. Crear una copia nueva de la plantilla únicamente con ese permiso. Registrar
28
+ variante, superficie, versión y evidencia. Un wrapper no hereda los comandos
29
+ del CLI estándar. No ejecutar un cliente desconocido para identificarlo.
30
+ 3. Revisar documentación pertinente y acordar un método no mutante de inspección.
31
+ No arrancar sesiones ni hooks, autenticarse, actualizar o cargar contexto de
32
+ un proyecto. Si no hay método seguro, pedir observación manual acotada.
33
+ 4. Recoger etiquetas, identificadores documentados y restricciones con fecha y
34
+ procedencia. Inspeccionar sin confirmar selección: no cambiar modelos ni
35
+ persistir defaults. Mantener acceso `unknown` si solo hay un menú genérico.
36
+ 5. Contrastar datos y contradicciones sin probar inferencias. Conservar fecha
37
+ original y revisiones previas. Solicitar evidencia nueva si falta vigencia,
38
+ no cambiar timestamps para pasar el selector.
39
+ 6. Revisar privacidad, disponibilidad declarada y coste por separado. No crear
40
+ catálogo activo ni aprobar perfiles. Si corresponde, proponer después una
41
+ evaluación pequeña por rol, con permisos, llamadas y tiempo delimitados.
42
+
43
+ Este procedimiento todavía no se ha ejecutado con los clientes del usuario.
44
+ Su aprobación documental no autoriza estas acciones reales ni crea la carpeta.
45
+ No hay nuevos comandos de Agent-Toolkit para este flujo en esta entrega.
46
+
47
+ ## Modelos candidatos y datos pendientes
48
+
49
+ Todo modelo nuevo entra como candidato. La revisión del inventario no convierte
50
+ en verificadas las capacidades declaradas ni certifica el modelo que respondió.
51
+ Una declaración explícita del usuario es `user-declaration`; metadata concreta
52
+ del cliente es `client-metadata`. Conservar su alcance sin elevarlo a certeza.
53
+ Oferta genérica y declaración de acceso se registran separadas.
54
+
55
+ Para una futura conversión autorizada, respetar los [contratos existentes](../../docs/agentes/modelos/agent-model-selection-contracts.md):
56
+
57
+ - `availability` pertenece a la solicitud privada, no al catálogo reutilizable.
58
+ - Falta de pruebas puede dejar capacidades verificadas vacías y contexto `null`;
59
+ no implica que el modelo sea incapaz ni que su contexto sea ilimitado.
60
+ - Identificador, fuente o fecha pendientes mantienen el borrador. Sin perfiles
61
+ estructuralmente válidos no se genera un catálogo vacío ni un modelo inventado.
62
+ - No aprobar alias, asignar prioridades o igualar esfuerzos por marca o novedad.
63
+ - Un candidato, disponibilidad desconocida/caducada o una contradicción sin
64
+ resolver no se hacen admisibles copiando el formulario a un encargo.
65
+
66
+ El [selector local](../../docs/agentes/modelos/agent-model-selector.md) recomienda con datos
67
+ de confianza y no ejecuta. Evaluar calidad real y aprobar perfiles requiere una
68
+ etapa separada; el inventario no da permiso para inferencias o aplicación.
69
+
70
+ ## Privacidad, consumo y efectos secundarios
71
+
72
+ Guardar solo lo necesario: referencias locales y resúmenes, no correos, nombres
73
+ legales, IDs de cuenta, secretos, conversaciones completas o logs extensos.
74
+ No leer almacenes de autenticación ni variables de credenciales para completar
75
+ el formulario. Una captura autorizada se recorta y redacta antes de guardarla
76
+ o compartirla; no publicar inventarios de cuenta en la biblioteca ni en Obsidian.
77
+
78
+ No compartir información de cuenta entre proveedores por defecto. Un traspaso
79
+ posterior incluirá únicamente el perfil y evidencia pertinentes autorizados,
80
+ no todo el inventario. Una huella no anonimiza ni prueba consentimiento.
81
+
82
+ Una sesión de cuenta no demuestra inclusión en una suscripción. Consumo
83
+ desconocido o facturación adicional bloquean la futura prueba hasta resolverlo.
84
+ No contratar API, activar créditos, cambiar autenticación/proveedor o prometer
85
+ cuotas ilimitadas. Alias, auxiliares y fallback opacos quedan como limitaciones,
86
+ sin reintentos o cambios de protecciones para evitarlos.
87
+
88
+ ## Escenarios revisados de esta base
89
+
90
+ Los casos son documentales y usan un cliente ficticio `demo-cli`, variante
91
+ `demo-wrapper` y opción `Demo Small`, sin atribuir modelos reales a cuentas.
92
+ No se crearon inventarios privados ni ejecutaron clientes para estos escenarios.
93
+
94
+ | ID | Escenario y resultado esperado | Dónde se conserva la regla |
95
+ | --- | --- | --- |
96
+ | CA-01 | Variante desconocida: registrar pendiente, sin ejecutar ni asumir comandos del estándar | Formulario 2 y pasos 2–3 |
97
+ | CA-02 | Opción visible sin acceso: oferta registrada, disponibilidad `unknown` | Formulario 4 y 4A |
98
+ | CA-03 | Declaración disponible frente a metadata negativa: conservar ambas, bloquear conversión y pedir resolución | Formulario 3 y 4A |
99
+ | CA-04 | Modelo nuevo sin prueba: `candidate`, sin capacidades verificadas ni aprobación por rol | Formulario 4B |
100
+ | CA-05 | Identificador, fuente o fecha pendientes: borrador, sin JSON inventado ni catálogo vacío | Formulario 4, 5 y reglas de conversión |
101
+ | CA-06 | Evidencia caducada o futura: solicitar comprobación pertinente, conservar fecha original | Formulario 3 y 4A |
102
+ | CA-07 | Selección que escribe defaults o consumo adicional: solo inspeccionar; no llamar mientras coste siga pendiente | Formulario 4C y paso 4 |
103
+ | CA-08 | Cuota, alias, auxiliares o fallback opacos: registrar límites, sin reintento ni proveedor alternativo | Formulario 4C |
104
+ | CA-09 | Captura privada: resumir o recortar con permiso y guardar solo en ruta privada acordada | Formulario 1, 3, 5 y privacidad |
105
+ | CA-10 | Crear formularios: solo Markdown, sin cambios a clientes, pilotos, código o archivos ajenos | Alcance y evidencia en la especificación |
106
+
107
+ Esta matriz comprueba cobertura documental, no acceso efectivo, cumplimiento
108
+ de agentes o barreras técnicas. Una plantilla por sí sola no protege los archivos.
109
+
110
+ ## Siguiente etapa
111
+
112
+ Revisar esta entrega y autorizar su commit local si se desea. Después acordar
113
+ ruta privada y recogida de un solo cliente identificado. No hacer inferencias,
114
+ crear políticas activas o seleccionar modelos como parte implícita de esa recogida.
115
+ La evaluación por rol y la ejecución futura tienen sus propias puertas.
@@ -0,0 +1,67 @@
1
+ # Plantilla canónica de memoria de proyecto
2
+
3
+ Esta plantilla es una base reutilizable para organizar la memoria de un proyecto: sus decisiones, su arquitectura, sus entregas y el contexto que necesitan los agentes, guardados aparte del código fuente. Cada proyecto empieza con una copia limpia, sin información de otros proyectos. Copiarla no deja la memoria ni la conexión con los agentes funcionando: hay que personalizarla, validarla y comprobarla como se explica más abajo.
4
+
5
+ ## Contenido
6
+
7
+ - `project-memory.example.json`: manifiesto válido y seguro que sirve como punto de partida.
8
+ - `vault/`: estructura mínima para una bóveda de Obsidian versionada con Git.
9
+ - `skill/project-id/`: Skill específica que enseña a los agentes cómo consultar la memoria.
10
+
11
+ ## Variables de plantilla
12
+
13
+ Los archivos Markdown utilizan estas variables:
14
+
15
+ | Variable | Significado |
16
+ | --- | --- |
17
+ | `{{PROJECT_ID}}` | Identificador corto en minúsculas y con guiones |
18
+ | `{{PROJECT_NAME}}` | Nombre visible del proyecto |
19
+ | `{{SOURCE_REPOSITORY}}` | Ruta o nombre del repositorio fuente |
20
+ | `{{MEMORY_REPOSITORY}}` | Nombre del repositorio privado de memoria |
21
+ | `{{MCP_SERVER_NAME}}` | Nombre único del servidor MCP |
22
+ | `{{DEFAULT_BRANCH}}` | Rama principal del repositorio fuente |
23
+ | `{{INTEGRATION_BRANCH}}` | Rama donde se integran cambios, si existe |
24
+ | `{{DATE}}` | Fecha absoluta en formato `AAAA-MM-DD` |
25
+
26
+ El comando `project-memory init` ya sustituye estas variables al preparar una memoria nueva. Por defecto muestra una vista previa; solo `--apply` crea los archivos. No configura Git, MCP ni enlaces globales. Consulta la [guía de creación](../../docs/memoria/project-memory-init.md) y ejecuta `project-memory doctor <destino> --strict` antes de conectar agentes. En una preparación manual, sustituye las variables antes de activar la Skill.
27
+
28
+ ## Estructura de la bóveda
29
+
30
+ ```text
31
+ vault/
32
+ ├── 00-INICIO/
33
+ ├── 01-PRODUCTO/
34
+ ├── 02-ARQUITECTURA/
35
+ ├── 03-IMPLEMENTACION/
36
+ ├── 04-DECISIONES/
37
+ ├── 05-ENTREGAS/
38
+ ├── 06-OPERACION/
39
+ ├── 07-AGENTES/
40
+ ├── 08-RECURSOS/
41
+ └── 09-ARCHIVO/
42
+ ```
43
+
44
+ Las carpetas representan responsabilidades estables. Un proyecto puede añadir áreas propias sin cambiar el significado de las existentes.
45
+
46
+ El manifiesto utiliza `memory.layout.profile: canonical-v1` para exigir esta estructura. Una memoria anterior con una organización estable diferente puede usar el perfil `declared` y enumerar sus carpetas y notas fundamentales, sin renombrarlas ni duplicarlas.
47
+
48
+ ## Alternativa de preparación manual
49
+
50
+ 1. Copiar esta carpeta fuera de `Agent-Toolkit`.
51
+ 2. Reemplazar todas las variables `{{...}}`.
52
+ 3. Adaptar `project-memory.example.json` y validarlo con el esquema canónico.
53
+ 4. Renombrar la carpeta de la Skill con `{{PROJECT_ID}}`.
54
+ 5. Crear un repositorio Git privado para la bóveda.
55
+ 6. Configurar un MCP limitado a la ruta de la bóveda y desactivar sus herramientas de escritura.
56
+ 7. Enlazar la Skill en cada agente y comprobar una consulta real.
57
+
58
+ ## Reglas de seguridad
59
+
60
+ - No copiar archivos `.env`, credenciales, tokens ni claves.
61
+ - No incluir secretos dentro de URLs del manifiesto.
62
+ - No habilitar escritura MCP.
63
+ - No sobrescribir una bóveda existente.
64
+ - No presentar una integración como activa antes de comprobarla.
65
+ - No tratar ramas abiertas como estado vigente.
66
+
67
+ La plantilla es una base, no una instalación terminada. Debe personalizarse y validarse para cada proyecto.
@@ -0,0 +1,53 @@
1
+ {
2
+ "$schema": "../../schemas/project-memory.schema.json",
3
+ "schemaVersion": "1.0.0",
4
+ "project": {
5
+ "id": "project-id",
6
+ "name": "Project Name",
7
+ "description": "Memoria organizada y privada del proyecto."
8
+ },
9
+ "source": {
10
+ "repositoryPath": "/absolute/path/to/project",
11
+ "remoteUrl": "https://example.com/owner/project.git",
12
+ "defaultBranch": "main",
13
+ "integrationBranch": "develop",
14
+ "documentationPaths": [
15
+ "README.md",
16
+ "docs"
17
+ ]
18
+ },
19
+ "memory": {
20
+ "vaultPath": "/absolute/path/to/project-memory",
21
+ "repositoryRemote": "https://example.com/owner/project-memory.git",
22
+ "repositoryBranch": "main",
23
+ "mcpServerName": "project-id-memory",
24
+ "syncMode": "git-manual",
25
+ "layout": {
26
+ "profile": "canonical-v1"
27
+ }
28
+ },
29
+ "agents": [
30
+ {
31
+ "id": "codex",
32
+ "enabled": true,
33
+ "skillName": "project-id"
34
+ },
35
+ {
36
+ "id": "claude",
37
+ "enabled": true,
38
+ "skillName": "project-id"
39
+ }
40
+ ],
41
+ "security": {
42
+ "mcpAccess": "read-only",
43
+ "sensitiveDataPolicy": "forbidden",
44
+ "writeRequiresExplicitAuthorization": true,
45
+ "allowCredentialsInMemory": false
46
+ },
47
+ "automation": {
48
+ "enabled": false,
49
+ "reviewBranch": "develop",
50
+ "requiresMergedChange": true,
51
+ "schedule": "Not configured"
52
+ }
53
+ }
@@ -0,0 +1,37 @@
1
+ ---
2
+ name: project-id
3
+ description: Consulta la memoria privada de Project Name cuando una tarea necesite contexto, decisiones o estado previo. No la uses para otros proyectos.
4
+ ---
5
+
6
+ # Contexto de Project Name
7
+
8
+ Usa esta Skill para recuperar únicamente el contexto necesario de la memoria del proyecto.
9
+
10
+ ## Flujo
11
+
12
+ 1. Identifica el área relacionada con la solicitud.
13
+ 2. Consulta [el perfil del proyecto](references/project-profile.md) cuando necesites ubicar la fuente adecuada.
14
+ 3. Usa el MCP `project-id-memory`; busca o lista antes de leer.
15
+ 4. Consulta el repositorio fuente cuando la respuesta dependa del comportamiento actual.
16
+ 5. Indica las notas consultadas e informa vacíos o contradicciones.
17
+
18
+ ## Fuente principal de verdad
19
+
20
+ El repositorio definido en el perfil, su código, pruebas, configuración y documentación vigente tienen prioridad sobre la memoria.
21
+
22
+ ## Mantenimiento
23
+
24
+ Al cerrar un cambio estable, consulta `00-INICIO/Mantenimiento de la memoria.md` y determina si alguna nota quedó desactualizada. Una rama abierta no modifica por sí sola la memoria vigente.
25
+
26
+ Para ejecutar el cierre, usa la skill global `cerrar-memoria` cuando esté
27
+ instalada. Es la misma para todos los proyectos: identifica esta bóveda por
28
+ `project-memory.json` y conserva sus reglas. No crees un comando de cierre
29
+ específico de Project Name. El manifiesto está tres niveles por encima de la
30
+ carpeta física de esta skill (`07-AGENTES/skills/project-id`).
31
+
32
+ ## Seguridad
33
+
34
+ - El MCP permanece en modo de solo lectura.
35
+ - No leas ni almacenes secretos, credenciales, tokens o datos sensibles.
36
+ - No modifiques la memoria sin autorización explícita o automatización autorizada.
37
+ - No simules una consulta si la memoria no está disponible.
@@ -0,0 +1,44 @@
1
+ # Perfil del proyecto
2
+
3
+ ## Identidad
4
+
5
+ - Identificador: `{{PROJECT_ID}}`
6
+ - Nombre: {{PROJECT_NAME}}
7
+ - Propósito:
8
+
9
+ ## Fuentes
10
+
11
+ - Repositorio principal: `{{SOURCE_REPOSITORY}}`
12
+ - Memoria: `{{MEMORY_REPOSITORY}}`
13
+ - MCP de solo lectura: `{{MCP_SERVER_NAME}}`
14
+ - Rama principal: `{{DEFAULT_BRANCH}}`
15
+ - Rama de integración: `{{INTEGRATION_BRANCH}}`
16
+
17
+ ## Áreas
18
+
19
+ | Necesidad | Ubicación inicial |
20
+ | --- | --- |
21
+ | Orientación | `00-INICIO/` |
22
+ | Producto | `01-PRODUCTO/` |
23
+ | Arquitectura | `02-ARQUITECTURA/` |
24
+ | Implementación | `03-IMPLEMENTACION/` |
25
+ | Decisiones | `04-DECISIONES/` |
26
+ | Entregas | `05-ENTREGAS/` |
27
+ | Operación | `06-OPERACION/` |
28
+
29
+ ## Reglas de autoría
30
+
31
+ - Completar con las reglas reales del proyecto antes de instalar la Skill.
32
+
33
+ ## Información prohibida
34
+
35
+ - Secretos y credenciales.
36
+ - Valores de archivos `.env`.
37
+ - Datos personales o sensibles innecesarios.
38
+
39
+ ## Señales de desactualización
40
+
41
+ - Contradicciones con el repositorio.
42
+ - Versiones sin verificar.
43
+ - Decisiones sin estado o evidencia.
44
+ - Notas que describen trabajo todavía no integrado.
@@ -0,0 +1,44 @@
1
+ ---
2
+ tipo: estado
3
+ estado: plantilla
4
+ ultima_verificacion: "{{DATE}}"
5
+ fuentes:
6
+ - "{{SOURCE_REPOSITORY}}"
7
+ ---
8
+
9
+ # Estado actual de {{PROJECT_NAME}}
10
+
11
+ ## Resumen
12
+
13
+ Describe únicamente el estado comprobado y relevante para continuar el trabajo.
14
+
15
+ ## Infraestructura de la memoria
16
+
17
+ | Componente | Estado | Evidencia |
18
+ | --- | --- | --- |
19
+ | Bóveda | Pendiente de comprobar | |
20
+ | Repositorio privado de memoria | Pendiente de comprobar | |
21
+ | MCP `{{MCP_SERVER_NAME}}` | Pendiente de comprobar | |
22
+ | Skill `{{PROJECT_ID}}` | Pendiente de comprobar | |
23
+ | Sincronización | Pendiente de comprobar | |
24
+
25
+ ## Avance por área
26
+
27
+ | Área | Estado | Siguiente objetivo |
28
+ | --- | --- | --- |
29
+ | Producto | Sin verificar | |
30
+ | Arquitectura | Sin verificar | |
31
+ | Implementación | Sin verificar | |
32
+ | Decisiones | Sin verificar | |
33
+ | Entregas | Sin verificar | |
34
+ | Operación | Sin verificar | |
35
+
36
+ ## Riesgos y limitaciones
37
+
38
+ - Registrar únicamente riesgos vigentes y respaldados por evidencia.
39
+
40
+ ## Próximas prioridades
41
+
42
+ 1. Confirmar las fuentes principales.
43
+ 2. Verificar las integraciones antes de marcarlas como configuradas.
44
+ 3. Documentar progresivamente sin copiar el repositorio.
@@ -0,0 +1,30 @@
1
+ # Fuentes de verdad
2
+
3
+ ## Prioridad
4
+
5
+ 1. Código, pruebas y configuración vigente de `{{SOURCE_REPOSITORY}}`.
6
+ 2. Documentación versionada del repositorio.
7
+ 3. Decisiones aprobadas.
8
+ 4. Notas verificadas de esta memoria.
9
+ 5. Fuentes externas oficiales y versionadas.
10
+
11
+ ## Contradicciones
12
+
13
+ Cuando dos fuentes discrepen:
14
+
15
+ 1. Identificar las afirmaciones incompatibles.
16
+ 2. Revisar la evidencia y sus fechas.
17
+ 3. Usar el repositorio para describir el comportamiento actual.
18
+ 4. No inventar la intención del diseño.
19
+ 5. Proponer la corrección de la fuente desactualizada.
20
+
21
+ ## Evidencia adecuada
22
+
23
+ - Ruta y símbolo del código.
24
+ - Prueba automatizada.
25
+ - Pull Request fusionado.
26
+ - Documento versionado.
27
+ - Decisión aprobada.
28
+ - Documentación oficial de una dependencia.
29
+
30
+ Una conversación o una rama sin integrar no representan por sí solas el estado vigente.
@@ -0,0 +1,44 @@
1
+ ---
2
+ tipo: inicio
3
+ estado: plantilla
4
+ ultima_verificacion: "{{DATE}}"
5
+ fuentes:
6
+ - "{{SOURCE_REPOSITORY}}"
7
+ ---
8
+
9
+ # Memoria central de {{PROJECT_NAME}}
10
+
11
+ Esta bóveda conserva el contexto estable necesario para trabajar en {{PROJECT_NAME}} sin cargar información innecesaria ni repetir investigaciones.
12
+
13
+ ## Fuente principal de verdad
14
+
15
+ El repositorio `{{SOURCE_REPOSITORY}}`, su código, pruebas, configuración y documentación vigente representan el comportamiento actual del proyecto.
16
+
17
+ La memoria resume contexto, decisiones y conocimiento durable. Si contradice al repositorio, se debe comprobar la diferencia y corregir la nota antes de tratarla como vigente.
18
+
19
+ ## Propósito
20
+
21
+ - Compartir contexto verificado entre personas y agentes.
22
+ - Registrar decisiones confirmadas y sus consecuencias.
23
+ - Evitar investigaciones y trabajos repetidos.
24
+ - Facilitar consultas pequeñas relacionadas con la tarea actual.
25
+ - Conservar resultados estables sin duplicar el repositorio.
26
+
27
+ ## Seguridad
28
+
29
+ No guardar contraseñas, tokens, claves, credenciales, archivos `.env` ni datos personales sensibles.
30
+
31
+ ## Navegación
32
+
33
+ - [[Mapa de la memoria]]
34
+ - [[Estado actual]]
35
+ - [[Fuentes de verdad]]
36
+ - [[Mantenimiento de la memoria]]
37
+ - [[Registro de sincronización]]
38
+ - [[Producto]]
39
+ - [[Arquitectura]]
40
+ - [[Implementación]]
41
+ - [[Decisiones]]
42
+ - [[Entregas]]
43
+ - [[Operación]]
44
+ - [[Protocolo de agentes]]
@@ -0,0 +1,26 @@
1
+ # Mantenimiento de la memoria
2
+
3
+ ## Cuándo revisar impacto
4
+
5
+ - Pull Request fusionado.
6
+ - Despliegue confirmado.
7
+ - Decisión aprobada.
8
+ - Cierre de una entrega o hito.
9
+ - Corrección de una contradicción comprobada.
10
+
11
+ ## Flujo
12
+
13
+ 1. Confirmar el evento y su evidencia.
14
+ 2. Identificar únicamente las notas potencialmente afectadas.
15
+ 3. Comparar cada afirmación con la fuente vigente.
16
+ 4. Determinar si existe un cambio documental estable.
17
+ 5. Obtener autorización cuando no exista una automatización autorizada.
18
+ 6. Editar solamente las notas enumeradas.
19
+ 7. Comprobar formato, enlaces, fuentes y posibles secretos.
20
+ 8. Agregar rutas exactas, crear un commit descriptivo y sincronizar.
21
+
22
+ ## Condiciones de parada
23
+
24
+ Detener la actualización ante conflictos, pruebas fallidas, cambios ajenos, secretos, fuentes ambiguas o un push rechazado.
25
+
26
+ Un Pull Request abierto se considera trabajo en desarrollo y no modifica la memoria vigente.
@@ -0,0 +1,33 @@
1
+ # Mapa de la memoria
2
+
3
+ ## Áreas
4
+
5
+ | Carpeta | Contenido |
6
+ | --- | --- |
7
+ | `00-INICIO` | Propósito, fuentes, estado y reglas de mantenimiento. |
8
+ | `01-PRODUCTO` | Visión, usuarios, alcance, capacidades y reglas del dominio. |
9
+ | `02-ARQUITECTURA` | Componentes, datos, integraciones, seguridad y decisiones estructurales. |
10
+ | `03-IMPLEMENTACION` | Convenciones técnicas y explicaciones durables de implementación. |
11
+ | `04-DECISIONES` | Decisiones confirmadas, alternativas y consecuencias. |
12
+ | `05-ENTREGAS` | Hitos, versiones, resultados y pendientes verificables. |
13
+ | `06-OPERACION` | Despliegue, observabilidad, mantenimiento y respuesta a incidentes. |
14
+ | `07-AGENTES` | Protocolo y Skills específicas del proyecto. |
15
+ | `08-RECURSOS` | Diagramas, imágenes y material documental auxiliar. |
16
+ | `09-ARCHIVO` | Información retirada del uso activo que se conserva como historial. |
17
+
18
+ ## Regla de consulta
19
+
20
+ 1. Identificar la tarea actual.
21
+ 2. Buscar por nombre o concepto.
22
+ 3. Leer únicamente las notas relacionadas.
23
+ 4. Consultar el repositorio cuando la respuesta dependa del estado técnico actual.
24
+
25
+ No se debe leer toda la bóveda por defecto.
26
+
27
+ ## Regla de actualización
28
+
29
+ Toda actualización requiere autorización explícita o una automatización autorizada. El MCP `{{MCP_SERVER_NAME}}` permanece en modo de solo lectura.
30
+
31
+ ## Volver al inicio
32
+
33
+ - [[Inicio del proyecto]]