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.
- package/README.md +21 -0
- package/agents/AGENTS.md +36 -3
- package/agents/CONSTITUTION.md +1 -1
- package/agents/guides/00-index.md +4 -4
- package/agents/guides/ai/agent-only-cognition.md +10 -2
- package/agents/guides/ai/agent-only-swarms.md +4 -4
- package/agents/guides/ai/agent-operating-ergonomics.md +1 -1
- package/agents/guides/ai/ai-agentic.md +2 -4
- package/agents/guides/ai/beyond-llms.md +12 -2
- package/agents/guides/ai/multi-agent-systems.md +1 -1
- package/agents/guides/architecture/api-standards.md +9 -7
- package/agents/guides/architecture/critical-systems-arch.md +10 -4
- package/agents/guides/architecture/microservices.md +2 -2
- package/agents/guides/architecture/orchestration.md +3 -3
- package/agents/guides/architecture/systems-architecture.md +6 -0
- package/agents/guides/ops/cost-optimization.md +1 -1
- package/agents/guides/patterns/agentic-patterns.md +12 -40
- package/agents/guides/patterns/ai-native-scenarios.md +4 -4
- package/agents/guides/patterns/design-patterns.md +11 -65
- package/agents/guides/patterns/software-design-patterns.md +4 -2
- package/agents/guides/principles/clean-code-standards.md +1 -1
- package/agents/guides/principles/evaluation-strategy.md +18 -13
- package/agents/guides/principles/future-tech.md +1 -1
- package/agents/guides/principles/human-agent-collaboration.md +4 -3
- package/agents/guides/principles/legacy-tech.md +7 -3
- package/agents/guides/principles/testing-strategy.md +5 -3
- package/agents/guides/processes/loki-sdlc-phases.md +1 -1
- package/agents/guides/security/api-security.md +1 -1
- package/agents/guides/security/cryptography-standards.md +8 -2
- package/agents/guides/security/privacy-data-protection.md +2 -2
- package/agents/guides/security/secure-architecture.md +1 -1
- package/agents/skills/00-index.md +16 -16
- package/agents/skills/brain/active-inference.skill.md +1 -1
- package/agents/skills/brain/brain-mode.skill.md +9 -2
- package/agents/skills/brain/cost-benefit-router.skill.md +20 -8
- package/agents/skills/brain/loki-mode.skill.md +13 -10
- package/agents/skills/brain/sequential-thinking.skill.md +1 -1
- package/agents/skills/coding/mobile-dev.skill.md +1 -0
- package/agents/skills/coding/secure-coding.skill.md +1 -1
- package/agents/skills/coding/tdd-cycle.skill.md +1 -1
- package/agents/skills/coding/testing-strategy.skill.md +1 -1
- package/agents/skills/coding/visual-design.skill.md +1 -0
- package/agents/skills/coordination/agent-interop.skill.md +5 -4
- package/agents/skills/coordination/meta-optimize.skill.md +2 -2
- package/agents/skills/coordination/multi-agent-orch.skill.md +1 -1
- package/agents/skills/coordination/persona-selector.skill.md +1 -1
- package/agents/skills/coordination/self-optimize.skill.md +1 -1
- package/agents/skills/coordination/swarm-consensus.skill.md +10 -0
- package/agents/skills/core/audit-trail.skill.md +1 -1
- package/agents/skills/core/emerging-tech.skill.md +1 -1
- package/agents/skills/core/integrity-check.skill.md +1 -1
- package/agents/skills/core/knowledge-connect.skill.md +1 -0
- package/agents/skills/core/preflight.skill.md +8 -0
- package/agents/skills/core/sdlc-checkpoint.skill.md +7 -2
- package/agents/skills/core/self-heal.skill.md +17 -4
- package/agents/skills/core/session-resume.skill.md +8 -3
- package/agents/skills/core/state-portability.skill.md +3 -2
- package/agents/skills/ops/incident-response.skill.md +1 -0
- package/agents/skills/ops/production-health.skill.md +1 -0
- package/agents/skills/ops/release-management.skill.md +1 -0
- package/agents/skills/ops/system-benchmark.skill.md +1 -0
- package/agents/skills/product/spec-writer.skill.md +6 -3
- package/agents/skills/security/ai-safety-guardrails.skill.md +15 -6
- package/agents/skills/security/legal-review.skill.md +1 -0
- package/agents/skills/security/reliability-engineering.skill.md +4 -3
- package/agents/templates/coding/CLEAN_CODE_CHECKLIST.md +1 -1
- package/agents/templates/coding/EVAL_RUBRIC_TEMPLATE.md +7 -0
- package/agents/templates/coding/GOLDEN_DATASET_TEMPLATE.md +1 -1
- package/agents/templates/coding/TEST_PLAN_TEMPLATE.md +2 -2
- package/agents/templates/coordination/AGENTS_TEMPLATE.md +133 -16
- package/agents/templates/core/AUDIT_LOG_TEMPLATE.md +1 -1
- package/agents/templates/core/SESSION_SNAPSHOT_TEMPLATE.md +3 -3
- package/agents/templates/ops/TECH_DEBT_TEMPLATE.md +1 -1
- package/agents/templates/product/PRD_TEMPLATE.md +8 -2
- package/agents/templates/product/SPEC_TEMPLATE.md +9 -3
- package/agents/templates/product/VISUAL_SPEC_PACKAGE_TEMPLATE.md +1 -1
- package/bin/install.js +36 -6
- package/docs/CLI_REFERENCE.md +43 -5
- package/docs/INSTALL.md +23 -10
- package/docs/adr/0002-brain-active-inference-runtime.md +29 -8
- package/package.json +2 -2
- 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`)
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
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
|
|
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
|
-
-
|
|
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.
|
|
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/",
|