gabbe-kit 1.0.3 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. package/README.md +21 -0
  2. package/agents/AGENTS.md +36 -3
  3. package/agents/CONSTITUTION.md +1 -1
  4. package/agents/guides/00-index.md +4 -4
  5. package/agents/guides/ai/agent-only-cognition.md +10 -2
  6. package/agents/guides/ai/agent-only-swarms.md +4 -4
  7. package/agents/guides/ai/agent-operating-ergonomics.md +1 -1
  8. package/agents/guides/ai/ai-agentic.md +2 -4
  9. package/agents/guides/ai/beyond-llms.md +12 -2
  10. package/agents/guides/ai/multi-agent-systems.md +1 -1
  11. package/agents/guides/architecture/api-standards.md +9 -7
  12. package/agents/guides/architecture/critical-systems-arch.md +10 -4
  13. package/agents/guides/architecture/microservices.md +2 -2
  14. package/agents/guides/architecture/orchestration.md +3 -3
  15. package/agents/guides/architecture/systems-architecture.md +6 -0
  16. package/agents/guides/ops/cost-optimization.md +1 -1
  17. package/agents/guides/patterns/agentic-patterns.md +12 -40
  18. package/agents/guides/patterns/ai-native-scenarios.md +4 -4
  19. package/agents/guides/patterns/design-patterns.md +11 -65
  20. package/agents/guides/patterns/software-design-patterns.md +4 -2
  21. package/agents/guides/principles/clean-code-standards.md +1 -1
  22. package/agents/guides/principles/evaluation-strategy.md +18 -13
  23. package/agents/guides/principles/future-tech.md +1 -1
  24. package/agents/guides/principles/human-agent-collaboration.md +4 -3
  25. package/agents/guides/principles/legacy-tech.md +7 -3
  26. package/agents/guides/principles/testing-strategy.md +5 -3
  27. package/agents/guides/processes/loki-sdlc-phases.md +1 -1
  28. package/agents/guides/security/api-security.md +1 -1
  29. package/agents/guides/security/cryptography-standards.md +8 -2
  30. package/agents/guides/security/privacy-data-protection.md +2 -2
  31. package/agents/guides/security/secure-architecture.md +1 -1
  32. package/agents/skills/00-index.md +16 -16
  33. package/agents/skills/brain/active-inference.skill.md +1 -1
  34. package/agents/skills/brain/brain-mode.skill.md +9 -2
  35. package/agents/skills/brain/cost-benefit-router.skill.md +20 -8
  36. package/agents/skills/brain/loki-mode.skill.md +13 -10
  37. package/agents/skills/brain/sequential-thinking.skill.md +1 -1
  38. package/agents/skills/coding/mobile-dev.skill.md +1 -0
  39. package/agents/skills/coding/secure-coding.skill.md +1 -1
  40. package/agents/skills/coding/tdd-cycle.skill.md +1 -1
  41. package/agents/skills/coding/testing-strategy.skill.md +1 -1
  42. package/agents/skills/coding/visual-design.skill.md +1 -0
  43. package/agents/skills/coordination/agent-interop.skill.md +5 -4
  44. package/agents/skills/coordination/meta-optimize.skill.md +2 -2
  45. package/agents/skills/coordination/multi-agent-orch.skill.md +1 -1
  46. package/agents/skills/coordination/persona-selector.skill.md +1 -1
  47. package/agents/skills/coordination/self-optimize.skill.md +1 -1
  48. package/agents/skills/coordination/swarm-consensus.skill.md +10 -0
  49. package/agents/skills/core/audit-trail.skill.md +1 -1
  50. package/agents/skills/core/emerging-tech.skill.md +1 -1
  51. package/agents/skills/core/integrity-check.skill.md +1 -1
  52. package/agents/skills/core/knowledge-connect.skill.md +1 -0
  53. package/agents/skills/core/preflight.skill.md +8 -0
  54. package/agents/skills/core/sdlc-checkpoint.skill.md +7 -2
  55. package/agents/skills/core/self-heal.skill.md +17 -4
  56. package/agents/skills/core/session-resume.skill.md +8 -3
  57. package/agents/skills/core/state-portability.skill.md +3 -2
  58. package/agents/skills/ops/incident-response.skill.md +1 -0
  59. package/agents/skills/ops/production-health.skill.md +1 -0
  60. package/agents/skills/ops/release-management.skill.md +1 -0
  61. package/agents/skills/ops/system-benchmark.skill.md +1 -0
  62. package/agents/skills/product/spec-writer.skill.md +6 -3
  63. package/agents/skills/security/ai-safety-guardrails.skill.md +15 -6
  64. package/agents/skills/security/legal-review.skill.md +1 -0
  65. package/agents/skills/security/reliability-engineering.skill.md +4 -3
  66. package/agents/templates/coding/CLEAN_CODE_CHECKLIST.md +1 -1
  67. package/agents/templates/coding/EVAL_RUBRIC_TEMPLATE.md +7 -0
  68. package/agents/templates/coding/GOLDEN_DATASET_TEMPLATE.md +1 -1
  69. package/agents/templates/coding/TEST_PLAN_TEMPLATE.md +2 -2
  70. package/agents/templates/coordination/AGENTS_TEMPLATE.md +133 -16
  71. package/agents/templates/core/AUDIT_LOG_TEMPLATE.md +1 -1
  72. package/agents/templates/core/SESSION_SNAPSHOT_TEMPLATE.md +3 -3
  73. package/agents/templates/ops/TECH_DEBT_TEMPLATE.md +1 -1
  74. package/agents/templates/product/PRD_TEMPLATE.md +8 -2
  75. package/agents/templates/product/SPEC_TEMPLATE.md +9 -3
  76. package/agents/templates/product/VISUAL_SPEC_PACKAGE_TEMPLATE.md +1 -1
  77. package/bin/install.js +36 -6
  78. package/docs/CLI_REFERENCE.md +43 -5
  79. package/docs/INSTALL.md +23 -10
  80. package/docs/adr/0002-brain-active-inference-runtime.md +29 -8
  81. package/package.json +2 -2
  82. package/scripts/init.py +488 -8
@@ -12,16 +12,37 @@ not capture cost/benefit trade-offs or episodic memory.
12
12
 
13
13
  ## Decision
14
14
 
15
- Brain Mode (`gabbe/brain.py`) implements an Active-Inference / OODA control loop:
16
- Observe (read PROJECT_STATE, audit log, recent outputs) → Orient → Decide (route
17
- local vs remote via a cost-benefit router) → Act, with evolutionary prompt
18
- optimization ("genes" persisted in SQLite) and episodic memory recall. This is an
19
- **experimental** runtime: it is documented as such and gated behind explicit
20
- `gabbe brain` subcommands, never on by default.
15
+ Brain Mode (`gabbe/brain.py`) is framed conceptually as an Active-Inference / OODA
16
+ control loop, but its actual mechanism is deliberately small. Each activation:
17
+
18
+ 1. **Reads project state** — a single `GROUP BY status` count of tasks in SQLite
19
+ (the "observation"; not a read of PROJECT_STATE.md, the audit log, or recent outputs).
20
+ 2. **Selects a prompt gene** via **epsilon-greedy** (≈20% explore the newest generation,
21
+ else exploit the highest `success_rate`); genes are persisted in SQLite.
22
+ 3. **Calls the LLM** once (through the gateway, under budget/hardstop controls) to emit
23
+ a high-level action description.
24
+ 4. **Bumps `success_rate`** for the chosen gene by a fixed delta on success — a
25
+ **monotonic** increment capped at 1.0. There is no free-energy computation, no
26
+ prediction-error update, and no episodic-memory recall in this loop.
27
+
28
+ Active Inference and OODA are therefore **framing, not math**: they name the intent
29
+ (observe → choose → act → reinforce), not a literal variational free-energy implementation.
30
+ **Cost/complexity routing is a separate concern** handled by `gabbe route` (and described
31
+ conceptually in `agents/guides/ai/self-evolving-skills.md`), not inside this loop. This is
32
+ an **experimental** runtime: documented as such and gated behind explicit `gabbe brain`
33
+ subcommands, never on by default.
21
34
 
22
35
  ## Consequences
23
36
 
24
- - The cost router and budget/hardstop controls are first-class, not bolt-ons.
37
+ - The budget/hardstop controls are first-class, not bolt-ons; routing (`gabbe route`) is a
38
+ distinct, separately-invoked capability rather than a step inside the Brain loop.
25
39
  - Because it is experimental, claims in the README are marked Experimental and
26
40
  link to reproducible examples rather than implying production guarantees.
27
- - The loop is deterministic enough to be replayed (`gabbe replay`) for audit.
41
+ - **Replay is deterministic because `gabbe replay` re-emits RECORDED outputs from
42
+ checkpoints** — the live loop itself is stochastic (epsilon-greedy gene selection plus
43
+ a non-deterministic LLM call), so a fresh live run is not bit-for-bit reproducible.
44
+
45
+ > **Honesty note:** the Active-Inference / OODA description is conceptual framing for how
46
+ > the loop is organized, not a claim that `brain.py` minimizes free energy. The production
47
+ > engine is epsilon-greedy gene selection over a monotonic `success_rate` — see the same
48
+ > caveat in `agents/skills/brain/cognitive-testing.skill.md` and the brain README.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "gabbe-kit",
3
- "version": "1.0.3",
3
+ "version": "1.1.1",
4
4
  "description": "GABBE - Generative Architectural Brain Base Engine. A Markdown agentic engineering kit installer (Python-independent). Wires AGENTS.md, skills, and per-agent rule files into any project.",
5
5
  "keywords": [
6
6
  "agentic",
@@ -30,7 +30,7 @@
30
30
  "gabbe-kit": "bin/install.js"
31
31
  },
32
32
  "scripts": {
33
- "test": "node bin/install.js --help"
33
+ "test": "node bin/install.js --help && node scripts/tests/test_node_install.js"
34
34
  },
35
35
  "files": [
36
36
  "bin/",