gabbe-kit 1.0.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.
- package/LICENSE +25 -0
- package/LICENSE-CODE +202 -0
- package/README.md +817 -0
- package/agents/AGENTS.md +542 -0
- package/agents/CONSTITUTION.md +188 -0
- package/agents/guides/00-index.md +142 -0
- package/agents/guides/ai/a2ui-protocols.md +71 -0
- package/agents/guides/ai/actor-agent-frameworks.md +82 -0
- package/agents/guides/ai/agent-communication.md +146 -0
- package/agents/guides/ai/agent-identity-trust.md +69 -0
- package/agents/guides/ai/agent-only-cognition.md +73 -0
- package/agents/guides/ai/agent-only-swarms.md +70 -0
- package/agents/guides/ai/agent-operating-ergonomics.md +52 -0
- package/agents/guides/ai/agent-ui.md +106 -0
- package/agents/guides/ai/ai-agentic.md +309 -0
- package/agents/guides/ai/beyond-llms.md +60 -0
- package/agents/guides/ai/dynamic-capability-loading.md +121 -0
- package/agents/guides/ai/gabbe-innovations.md +111 -0
- package/agents/guides/ai/model-customization-decisions.md +78 -0
- package/agents/guides/ai/multi-agent-systems.md +85 -0
- package/agents/guides/ai/self-evolving-skills.md +137 -0
- package/agents/guides/ai/self-healing-summary.md +21 -0
- package/agents/guides/ai/visual-mcp-integration.md +106 -0
- package/agents/guides/architecture/api-standards.md +61 -0
- package/agents/guides/architecture/blockchain-dlt.md +36 -0
- package/agents/guides/architecture/critical-systems-arch.md +66 -0
- package/agents/guides/architecture/event-driven-architecture.md +39 -0
- package/agents/guides/architecture/microservices.md +292 -0
- package/agents/guides/architecture/monolith.md +303 -0
- package/agents/guides/architecture/orchestration.md +75 -0
- package/agents/guides/architecture/system-qualities.md +51 -0
- package/agents/guides/architecture/system-scalability.md +47 -0
- package/agents/guides/architecture/systems-architecture.md +506 -0
- package/agents/guides/data/semantic-web.md +23 -0
- package/agents/guides/data/sql-nosql.md +305 -0
- package/agents/guides/industry/engineering-standards.md +36 -0
- package/agents/guides/industry/global-standards.md +24 -0
- package/agents/guides/industry/healthcare-fhir.md +33 -0
- package/agents/guides/industry/industrial-iot.md +33 -0
- package/agents/guides/industry/telecom-networks.md +34 -0
- package/agents/guides/languages/c-sharp.md +66 -0
- package/agents/guides/languages/go-lang.md +251 -0
- package/agents/guides/languages/java.md +73 -0
- package/agents/guides/languages/js-ts-nodejs.md +361 -0
- package/agents/guides/languages/nodejs-advanced.md +56 -0
- package/agents/guides/languages/php-laravel.md +376 -0
- package/agents/guides/languages/python-fastapi-ai.md +257 -0
- package/agents/guides/languages/rust.md +73 -0
- package/agents/guides/ops/compliance-audit.md +177 -0
- package/agents/guides/ops/cost-optimization.md +57 -0
- package/agents/guides/ops/dev-environments.md +67 -0
- package/agents/guides/ops/dev-workflow.md +44 -0
- package/agents/guides/ops/gabbe-cli-workflows.md +252 -0
- package/agents/guides/ops/production-health.md +62 -0
- package/agents/guides/ops/troubleshooting-guide.md +69 -0
- package/agents/guides/patterns/agentic-design-patterns.md +308 -0
- package/agents/guides/patterns/agentic-patterns.md +43 -0
- package/agents/guides/patterns/ai-native-scenarios.md +71 -0
- package/agents/guides/patterns/autonomous-swarm-patterns.md +42 -0
- package/agents/guides/patterns/design-patterns.md +68 -0
- package/agents/guides/patterns/enterprise-migration-scenario.md +58 -0
- package/agents/guides/patterns/enterprise-patterns.md +56 -0
- package/agents/guides/patterns/software-design-patterns.md +106 -0
- package/agents/guides/patterns/time-complexity-analysis.md +116 -0
- package/agents/guides/planning/product-requirements.md +407 -0
- package/agents/guides/planning/strategic-analysis.md +98 -0
- package/agents/guides/planning/visual-product-specs.md +162 -0
- package/agents/guides/principles/clean-code-standards.md +51 -0
- package/agents/guides/principles/computing-foundations.md +87 -0
- package/agents/guides/principles/diagramming-standards.md +568 -0
- package/agents/guides/principles/evaluation-strategy.md +103 -0
- package/agents/guides/principles/future-tech.md +35 -0
- package/agents/guides/principles/human-agent-collaboration.md +54 -0
- package/agents/guides/principles/legacy-tech.md +61 -0
- package/agents/guides/principles/mathematical-foundations.md +103 -0
- package/agents/guides/principles/modeling-methods.md +97 -0
- package/agents/guides/principles/no-code-integration.md +84 -0
- package/agents/guides/principles/testing-strategy.md +97 -0
- package/agents/guides/principles/visual-design-system.md +44 -0
- package/agents/guides/processes/RARV_CYCLE.md +262 -0
- package/agents/guides/processes/extension-protocol.md +183 -0
- package/agents/guides/processes/full-system-lifecycle.md +47 -0
- package/agents/guides/processes/knowledge-integration.md +82 -0
- package/agents/guides/processes/loki-sdlc-phases.md +446 -0
- package/agents/guides/product/green-software.md +38 -0
- package/agents/guides/product/sustainability-checks.md +29 -0
- package/agents/guides/security/ai-risk-standards-map.md +98 -0
- package/agents/guides/security/api-security.md +51 -0
- package/agents/guides/security/cryptography-standards.md +38 -0
- package/agents/guides/security/privacy-data-protection.md +41 -0
- package/agents/guides/security/secure-architecture.md +43 -0
- package/agents/guides/security/threat-modeling.md +46 -0
- package/agents/memory/AUDIT_LOG.md +48 -0
- package/agents/memory/CONTINUITY.md +49 -0
- package/agents/memory/PROJECT_STATE.md +134 -0
- package/agents/memory/RESUME_POINTER.md +15 -0
- package/agents/memory/episodic/DECISION_LOG_TEMPLATE.md +104 -0
- package/agents/memory/semantic/PROJECT_KNOWLEDGE_TEMPLATE.md +194 -0
- package/agents/memory/semantic/VECTOR_DB_CONFIG_TEMPLATE.json +46 -0
- package/agents/personas/00-index.md +148 -0
- package/agents/personas/biz-compliance.md +112 -0
- package/agents/personas/biz-legal.md +131 -0
- package/agents/personas/eng-api.md +110 -0
- package/agents/personas/eng-backend.md +113 -0
- package/agents/personas/eng-data.md +50 -0
- package/agents/personas/eng-database.md +95 -0
- package/agents/personas/eng-frontend.md +75 -0
- package/agents/personas/eng-infra.md +105 -0
- package/agents/personas/eng-messaging.md +50 -0
- package/agents/personas/eng-ml.md +50 -0
- package/agents/personas/eng-mobile.md +75 -0
- package/agents/personas/eng-perf.md +90 -0
- package/agents/personas/eng-qa.md +125 -0
- package/agents/personas/eng-tooling.md +49 -0
- package/agents/personas/ops-compliance.md +109 -0
- package/agents/personas/ops-cost.md +92 -0
- package/agents/personas/ops-devops.md +85 -0
- package/agents/personas/ops-incident.md +123 -0
- package/agents/personas/ops-monitor.md +89 -0
- package/agents/personas/ops-release.md +91 -0
- package/agents/personas/ops-security.md +104 -0
- package/agents/personas/ops-sre.md +85 -0
- package/agents/personas/orch-coordinator.md +140 -0
- package/agents/personas/orch-judge.md +135 -0
- package/agents/personas/orch-planner.md +114 -0
- package/agents/personas/orch-researcher.md +165 -0
- package/agents/personas/prod-architect.md +110 -0
- package/agents/personas/prod-design.md +112 -0
- package/agents/personas/prod-ethicist.md +50 -0
- package/agents/personas/prod-integration.md +120 -0
- package/agents/personas/prod-pm.md +115 -0
- package/agents/personas/prod-product-ops.md +128 -0
- package/agents/personas/prod-research.md +49 -0
- package/agents/personas/prod-safety-engineer.md +28 -0
- package/agents/personas/prod-tech-lead.md +119 -0
- package/agents/personas/ui-design.md +81 -0
- package/agents/scripts/check_skills_docs.py +120 -0
- package/agents/scripts/compile_skills.py +284 -0
- package/agents/scripts/comprehensive_checker.py +187 -0
- package/agents/scripts/dump-context.sh +37 -0
- package/agents/scripts/eval_skills.py +268 -0
- package/agents/scripts/preflight_summary.sh +80 -0
- package/agents/scripts/report_duplicates.py +125 -0
- package/agents/scripts/setup-context.ps1 +250 -0
- package/agents/scripts/setup-context.sh +398 -0
- package/agents/scripts/state_export.sh +84 -0
- package/agents/scripts/state_import.sh +99 -0
- package/agents/scripts/validate_integrity.py +98 -0
- package/agents/scripts/validate_links.py +96 -0
- package/agents/scripts/validate_methodology_graph.py +194 -0
- package/agents/scripts/validate_skills.py +81 -0
- package/agents/scripts/verify_e2e_init_flows.py +246 -0
- package/agents/scripts/verify_setup_simulation.py +104 -0
- package/agents/scripts/verify_triggers_and_mcps.py +159 -0
- package/agents/scripts/verify_use_cases.py +498 -0
- package/agents/skills/00-index.md +322 -0
- package/agents/skills/ai/a2ui-protocols.skill.md +31 -0
- package/agents/skills/ai/actor-agent-frameworks.skill.md +31 -0
- package/agents/skills/ai/agent-communication.skill.md +36 -0
- package/agents/skills/ai/agent-ui.skill.md +31 -0
- package/agents/skills/ai/autonomous-swarm-patterns.skill.md +31 -0
- package/agents/skills/ai/beyond-llms.skill.md +31 -0
- package/agents/skills/ai/context-engineering.skill.md +79 -0
- package/agents/skills/ai/llm-as-judge.skill.md +97 -0
- package/agents/skills/ai/multi-agent-systems.skill.md +31 -0
- package/agents/skills/ai/rag-evaluation.skill.md +93 -0
- package/agents/skills/ai/reasoning-patterns.skill.md +125 -0
- package/agents/skills/architecture/adaptive-architecture.skill.md +51 -0
- package/agents/skills/architecture/api-design.skill.md +92 -0
- package/agents/skills/architecture/api-standards.skill.md +31 -0
- package/agents/skills/architecture/arch-debt.skill.md +180 -0
- package/agents/skills/architecture/arch-design.skill.md +304 -0
- package/agents/skills/architecture/arch-patterns.skill.md +52 -0
- package/agents/skills/architecture/arch-review.skill.md +326 -0
- package/agents/skills/architecture/architecture-governance.skill.md +62 -0
- package/agents/skills/architecture/attribute-driven-design.skill.md +108 -0
- package/agents/skills/architecture/blockchain-dlt.skill.md +28 -0
- package/agents/skills/architecture/compatibility-design.skill.md +51 -0
- package/agents/skills/architecture/critical-systems-arch.skill.md +31 -0
- package/agents/skills/architecture/design-patterns.skill.md +59 -0
- package/agents/skills/architecture/diagramming.skill.md +380 -0
- package/agents/skills/architecture/domain-model.skill.md +294 -0
- package/agents/skills/architecture/enterprise-migration-scenario.skill.md +31 -0
- package/agents/skills/architecture/enterprise-patterns.skill.md +31 -0
- package/agents/skills/architecture/error-handling-strategy.skill.md +58 -0
- package/agents/skills/architecture/event-driven-architecture.skill.md +31 -0
- package/agents/skills/architecture/event-governance.skill.md +55 -0
- package/agents/skills/architecture/fitness-functions.skill.md +111 -0
- package/agents/skills/architecture/graphql-schema.skill.md +64 -0
- package/agents/skills/architecture/legacy-modernization.skill.md +51 -0
- package/agents/skills/architecture/microservices.skill.md +31 -0
- package/agents/skills/architecture/middleware-design.skill.md +59 -0
- package/agents/skills/architecture/monolith.skill.md +31 -0
- package/agents/skills/architecture/realtime-comm.skill.md +52 -0
- package/agents/skills/architecture/state-management.skill.md +72 -0
- package/agents/skills/architecture/system-qualities.skill.md +31 -0
- package/agents/skills/architecture/system-scalability.skill.md +31 -0
- package/agents/skills/architecture/systems-architecture.skill.md +31 -0
- package/agents/skills/architecture/visual-whiteboarding.skill.md +33 -0
- package/agents/skills/brain/README.md +70 -0
- package/agents/skills/brain/active-inference.skill.md +74 -0
- package/agents/skills/brain/brain-mode.skill.md +125 -0
- package/agents/skills/brain/cognitive-architectures.skill.md +53 -0
- package/agents/skills/brain/cognitive-testing.skill.md +62 -0
- package/agents/skills/brain/consciousness-loop.skill.md +68 -0
- package/agents/skills/brain/cost-benefit-router.skill.md +89 -0
- package/agents/skills/brain/episodic-consolidation.skill.md +43 -0
- package/agents/skills/brain/epistemology-knowledge.skill.md +54 -0
- package/agents/skills/brain/global-workspace.skill.md +77 -0
- package/agents/skills/brain/learning-adaptation.skill.md +68 -0
- package/agents/skills/brain/loki-mode.skill.md +267 -0
- package/agents/skills/brain/neuroscience-foundations.skill.md +52 -0
- package/agents/skills/brain/scripts/active_inference_loop.py +92 -0
- package/agents/skills/brain/scripts/cognition_test.py +80 -0
- package/agents/skills/brain/scripts/global_workspace.py +104 -0
- package/agents/skills/brain/self-improvement.skill.md +80 -0
- package/agents/skills/brain/sensory-motor.skill.md +61 -0
- package/agents/skills/brain/sequential-thinking.skill.md +48 -0
- package/agents/skills/brain/working-memory.skill.md +47 -0
- package/agents/skills/coding/agent-trajectory-eval.skill.md +92 -0
- package/agents/skills/coding/artisan-commands.skill.md +52 -0
- package/agents/skills/coding/browser-tdd.skill.md +131 -0
- package/agents/skills/coding/chaos-fault-injection.skill.md +116 -0
- package/agents/skills/coding/ci-autofix.skill.md +53 -0
- package/agents/skills/coding/clean-coder.skill.md +58 -0
- package/agents/skills/coding/code-review.skill.md +100 -0
- package/agents/skills/coding/debug.skill.md +100 -0
- package/agents/skills/coding/documentation.skill.md +149 -0
- package/agents/skills/coding/eval-driven-development.skill.md +107 -0
- package/agents/skills/coding/evals/code-review.eval.yaml +29 -0
- package/agents/skills/coding/excalidraw.skill.md +90 -0
- package/agents/skills/coding/file-processing.skill.md +55 -0
- package/agents/skills/coding/git-workflow.skill.md +153 -0
- package/agents/skills/coding/metamorphic-testing.skill.md +113 -0
- package/agents/skills/coding/mobile-dev.skill.md +41 -0
- package/agents/skills/coding/nodejs-expert.skill.md +23 -0
- package/agents/skills/coding/output-validation.skill.md +57 -0
- package/agents/skills/coding/pbt-strategy.skill.md +117 -0
- package/agents/skills/coding/performant-ai.skill.md +62 -0
- package/agents/skills/coding/performant-go.skill.md +61 -0
- package/agents/skills/coding/performant-laravel.skill.md +70 -0
- package/agents/skills/coding/performant-nodejs.skill.md +67 -0
- package/agents/skills/coding/performant-php.skill.md +53 -0
- package/agents/skills/coding/performant-python.skill.md +62 -0
- package/agents/skills/coding/refactor.skill.md +124 -0
- package/agents/skills/coding/secure-coding.skill.md +57 -0
- package/agents/skills/coding/sketch-to-diagram.skill.md +106 -0
- package/agents/skills/coding/spec-driven-development.skill.md +110 -0
- package/agents/skills/coding/tdd-cycle.skill.md +92 -0
- package/agents/skills/coding/testing-strategy.skill.md +74 -0
- package/agents/skills/coding/time-complexity.skill.md +112 -0
- package/agents/skills/coding/tldraw-canvas.skill.md +109 -0
- package/agents/skills/coding/tool-construction.skill.md +47 -0
- package/agents/skills/coding/ui-gen.skill.md +64 -0
- package/agents/skills/coding/vibe-coding.skill.md +63 -0
- package/agents/skills/coding/visual-design.skill.md +65 -0
- package/agents/skills/coordination/agent-interop.skill.md +72 -0
- package/agents/skills/coordination/agent-protocol.skill.md +62 -0
- package/agents/skills/coordination/agent-workflow-patterns.skill.md +123 -0
- package/agents/skills/coordination/agentic-linter.skill.md +134 -0
- package/agents/skills/coordination/agentic-patterns.skill.md +79 -0
- package/agents/skills/coordination/meta-optimize.skill.md +62 -0
- package/agents/skills/coordination/meta-prompting.skill.md +46 -0
- package/agents/skills/coordination/multi-agent-orch.skill.md +78 -0
- package/agents/skills/coordination/persona-selector.skill.md +78 -0
- package/agents/skills/coordination/self-optimize.skill.md +81 -0
- package/agents/skills/coordination/swarm-consensus.skill.md +52 -0
- package/agents/skills/core/agent-analytics.skill.md +74 -0
- package/agents/skills/core/audit-trail.skill.md +122 -0
- package/agents/skills/core/clarify.skill.md +89 -0
- package/agents/skills/core/emerging-tech.skill.md +52 -0
- package/agents/skills/core/empirical-methods.skill.md +101 -0
- package/agents/skills/core/evals/clarify.eval.yaml +29 -0
- package/agents/skills/core/evals/integrity-check.eval.yaml +23 -0
- package/agents/skills/core/evals/research.eval.yaml +23 -0
- package/agents/skills/core/final-review.skill.md +66 -0
- package/agents/skills/core/integrity-check.skill.md +149 -0
- package/agents/skills/core/knowledge-connect.skill.md +77 -0
- package/agents/skills/core/knowledge-gap.skill.md +123 -0
- package/agents/skills/core/preflight.skill.md +106 -0
- package/agents/skills/core/research.skill.md +107 -0
- package/agents/skills/core/retrospective.skill.md +59 -0
- package/agents/skills/core/sdlc-checkpoint.skill.md +151 -0
- package/agents/skills/core/self-heal.skill.md +163 -0
- package/agents/skills/core/session-resume.skill.md +125 -0
- package/agents/skills/core/skills-registry.skill.md +65 -0
- package/agents/skills/core/state-portability.skill.md +89 -0
- package/agents/skills/core/state-preserve.skill.md +76 -0
- package/agents/skills/core/system-lifecycle.skill.md +51 -0
- package/agents/skills/core/update-scan.skill.md +92 -0
- package/agents/skills/data/data-engineering.skill.md +56 -0
- package/agents/skills/data/data-governance.skill.md +49 -0
- package/agents/skills/data/db-migration.skill.md +136 -0
- package/agents/skills/data/semantic-web.skill.md +28 -0
- package/agents/skills/data/sql-optimization.skill.md +78 -0
- package/agents/skills/industry/engineering-standards.skill.md +31 -0
- package/agents/skills/industry/global-standards.skill.md +30 -0
- package/agents/skills/industry/healthcare-fhir.skill.md +28 -0
- package/agents/skills/industry/industrial-iot.skill.md +30 -0
- package/agents/skills/industry/telecom-networks.skill.md +30 -0
- package/agents/skills/ops/caching-strategy.skill.md +77 -0
- package/agents/skills/ops/capacity-planning.skill.md +67 -0
- package/agents/skills/ops/cloud-deploy.skill.md +55 -0
- package/agents/skills/ops/configuration-management.skill.md +107 -0
- package/agents/skills/ops/cost-optimization.skill.md +39 -0
- package/agents/skills/ops/decommission-sunset.skill.md +64 -0
- package/agents/skills/ops/dependency-lifecycle.skill.md +63 -0
- package/agents/skills/ops/deployment.skill.md +217 -0
- package/agents/skills/ops/dev-environments.skill.md +31 -0
- package/agents/skills/ops/dev-workflow.skill.md +28 -0
- package/agents/skills/ops/docker-dev.skill.md +52 -0
- package/agents/skills/ops/enterprise-integration.skill.md +53 -0
- package/agents/skills/ops/feature-flag-management.skill.md +59 -0
- package/agents/skills/ops/incident-response.skill.md +40 -0
- package/agents/skills/ops/infra-devops.skill.md +53 -0
- package/agents/skills/ops/k8s-dev.skill.md +51 -0
- package/agents/skills/ops/memory-optimization.skill.md +45 -0
- package/agents/skills/ops/observability-stack-setup.skill.md +62 -0
- package/agents/skills/ops/performance-audit.skill.md +178 -0
- package/agents/skills/ops/performance-optimization.skill.md +51 -0
- package/agents/skills/ops/production-health.skill.md +85 -0
- package/agents/skills/ops/production-verifier.skill.md +50 -0
- package/agents/skills/ops/queue-management.skill.md +52 -0
- package/agents/skills/ops/release-management.skill.md +39 -0
- package/agents/skills/ops/release-validation.skill.md +51 -0
- package/agents/skills/ops/reliability-sre.skill.md +51 -0
- package/agents/skills/ops/runbook-authoring.skill.md +64 -0
- package/agents/skills/ops/system-benchmark.skill.md +69 -0
- package/agents/skills/ops/tech-debt.skill.md +143 -0
- package/agents/skills/ops/troubleshooting-guide.skill.md +31 -0
- package/agents/skills/product/accessibility.skill.md +143 -0
- package/agents/skills/product/adr-writer.skill.md +110 -0
- package/agents/skills/product/business-case.skill.md +70 -0
- package/agents/skills/product/change-management.skill.md +90 -0
- package/agents/skills/product/decompose.skill.md +75 -0
- package/agents/skills/product/design-thinking.skill.md +62 -0
- package/agents/skills/product/estimation-sizing.skill.md +87 -0
- package/agents/skills/product/evals/spec-writer.eval.yaml +22 -0
- package/agents/skills/product/financial-governance.skill.md +88 -0
- package/agents/skills/product/green-software.skill.md +46 -0
- package/agents/skills/product/ideation-facilitation.skill.md +87 -0
- package/agents/skills/product/market-analysis.skill.md +56 -0
- package/agents/skills/product/opportunity-assessment.skill.md +89 -0
- package/agents/skills/product/product-analytics.skill.md +92 -0
- package/agents/skills/product/professional-practice.skill.md +105 -0
- package/agents/skills/product/req-elicitation.skill.md +292 -0
- package/agents/skills/product/req-review.skill.md +280 -0
- package/agents/skills/product/spec-analyze.skill.md +98 -0
- package/agents/skills/product/spec-writer.skill.md +114 -0
- package/agents/skills/product/stakeholder-management.skill.md +54 -0
- package/agents/skills/product/sustainability-checks.skill.md +29 -0
- package/agents/skills/product/systems-thinking.skill.md +56 -0
- package/agents/skills/product/user-research-synthesis.skill.md +85 -0
- package/agents/skills/product/user-story-mapping.skill.md +54 -0
- package/agents/skills/product/visual-specs.skill.md +112 -0
- package/agents/skills/security/access-control.skill.md +45 -0
- package/agents/skills/security/agent-sandboxing.skill.md +69 -0
- package/agents/skills/security/ai-ethics-compliance.skill.md +46 -0
- package/agents/skills/security/ai-red-teaming.skill.md +74 -0
- package/agents/skills/security/ai-safety-guardrails.skill.md +60 -0
- package/agents/skills/security/api-security.skill.md +31 -0
- package/agents/skills/security/backup-recovery.skill.md +49 -0
- package/agents/skills/security/compliance-review.skill.md +152 -0
- package/agents/skills/security/cryptography-standards.skill.md +31 -0
- package/agents/skills/security/dependency-security.skill.md +47 -0
- package/agents/skills/security/hazard-analysis.skill.md +53 -0
- package/agents/skills/security/legal-review.skill.md +41 -0
- package/agents/skills/security/log-analysis.skill.md +68 -0
- package/agents/skills/security/network-security.skill.md +64 -0
- package/agents/skills/security/privacy-audit.skill.md +137 -0
- package/agents/skills/security/privacy-data-protection.skill.md +31 -0
- package/agents/skills/security/prompt-injection-defense.skill.md +67 -0
- package/agents/skills/security/reliability-engineering.skill.md +47 -0
- package/agents/skills/security/safety-scan.skill.md +49 -0
- package/agents/skills/security/secrets-management.skill.md +65 -0
- package/agents/skills/security/secure-architecture.skill.md +31 -0
- package/agents/skills/security/security-audit.skill.md +164 -0
- package/agents/skills/security/threat-model.skill.md +120 -0
- package/agents/skills/security/traceability-audit.skill.md +48 -0
- package/agents/templates/00-index.md +162 -0
- package/agents/templates/architecture/ADAPTIVE_SYSTEM_TEMPLATE.md +35 -0
- package/agents/templates/architecture/ADD_WORKBOOK_TEMPLATE.md +81 -0
- package/agents/templates/architecture/ADR_TEMPLATE.md +136 -0
- package/agents/templates/architecture/ARCHITECTURE_DECISION_MATRIX.md +169 -0
- package/agents/templates/architecture/ARCHITECTURE_REVIEW_TEMPLATE.md +241 -0
- package/agents/templates/architecture/ARCHITECTURE_VIEWS_TEMPLATE.md +353 -0
- package/agents/templates/architecture/ARCH_DECISION_FRAMEWORK.md +32 -0
- package/agents/templates/architecture/C4_ARCHITECTURE_TEMPLATE.md +185 -0
- package/agents/templates/architecture/CAPABILITY_MAP_TEMPLATE.md +153 -0
- package/agents/templates/architecture/CONTEXT_MAP_TEMPLATE.md +196 -0
- package/agents/templates/architecture/DESIGN_PATTERN_USAGE.md +24 -0
- package/agents/templates/architecture/DOMAIN_MODEL_TEMPLATE.md +254 -0
- package/agents/templates/architecture/FITNESS_FUNCTION_TEMPLATE.md +59 -0
- package/agents/templates/architecture/INTEGRATION_SPEC_TEMPLATE.md +38 -0
- package/agents/templates/architecture/LEGACY_AUDIT_TEMPLATE.md +34 -0
- package/agents/templates/architecture/QUALITY_ATTRIBUTES_TEMPLATE.md +210 -0
- package/agents/templates/architecture/SCALABILITY_ANALYSIS_TEMPLATE.md +46 -0
- package/agents/templates/architecture/SMART_CONTRACT_TEMPLATE.md +44 -0
- package/agents/templates/architecture/SYSTEM_CONTEXT_TEMPLATE.md +197 -0
- package/agents/templates/brain/ACTIVE_INFERENCE_LOOP_TEMPLATE.md +42 -0
- package/agents/templates/brain/EPISODIC_MEMORY_LOG_TEMPLATE.md +28 -0
- package/agents/templates/brain/GLOBAL_WORKSPACE_CONFIG_TEMPLATE.md +44 -0
- package/agents/templates/brain/KNOWLEDGE_MAP_TEMPLATE.md +53 -0
- package/agents/templates/brain/OODA_LOOP_TRACE_TEMPLATE.md +44 -0
- package/agents/templates/brain/PREDICTION_ERROR_LOG_TEMPLATE.md +33 -0
- package/agents/templates/brain/PROJECT_CONTEXT_TEMPLATE.md +36 -0
- package/agents/templates/brain/SELF_IMPROVEMENT_LOG_TEMPLATE.md +39 -0
- package/agents/templates/brain/WORKING_MEMORY_TEMPLATE.md +34 -0
- package/agents/templates/coding/CLEAN_CODE_CHECKLIST.md +30 -0
- package/agents/templates/coding/DESIGN_TOKENS_TEMPLATE.json +54 -0
- package/agents/templates/coding/DEVCONTAINER_TEMPLATE.json +42 -0
- package/agents/templates/coding/DEV_SPACE_TEMPLATE.yaml +48 -0
- package/agents/templates/coding/E2E_TEST_SUITE_TEMPLATE.md +36 -0
- package/agents/templates/coding/EVAL_PLAN_TEMPLATE.md +85 -0
- package/agents/templates/coding/EVAL_RUBRIC_TEMPLATE.md +57 -0
- package/agents/templates/coding/GOLDEN_DATASET_TEMPLATE.md +73 -0
- package/agents/templates/coding/PROPERTY_TEST_CHECKLIST.md +77 -0
- package/agents/templates/coding/SKETCH_TO_DIAGRAM_TEMPLATE.md +56 -0
- package/agents/templates/coding/TEST_CASE_TEMPLATE.md +28 -0
- package/agents/templates/coding/TEST_PLAN_TEMPLATE.md +36 -0
- package/agents/templates/coding/TIME_COMPLEXITY_REPORT_TEMPLATE.md +61 -0
- package/agents/templates/coordination/AGENTS_TEMPLATE.md +540 -0
- package/agents/templates/coordination/AGENT_HANDSHAKE_TEMPLATE.json +37 -0
- package/agents/templates/coordination/AGENT_PROFILE_TEMPLATE.md +28 -0
- package/agents/templates/coordination/SWARM_ARCHITECTURE_TEMPLATE.md +53 -0
- package/agents/templates/coordination/SWARM_CONFIG_TEMPLATE.json +45 -0
- package/agents/templates/core/AUDIT_LOG_TEMPLATE.md +75 -0
- package/agents/templates/core/BUG_REPORT_TEMPLATE.md +136 -0
- package/agents/templates/core/DEPENDENCY_GRAPH_TEMPLATE.md +63 -0
- package/agents/templates/core/ESTIMATION_TEMPLATE.md +70 -0
- package/agents/templates/core/MCP_CONFIG_TEMPLATE.json +807 -0
- package/agents/templates/core/PLAN_TEMPLATE.md +162 -0
- package/agents/templates/core/PROJECT_RETROSPECTIVE_TEMPLATE.md +67 -0
- package/agents/templates/core/SDLC_TRACKER.md +217 -0
- package/agents/templates/core/SESSION_SNAPSHOT_TEMPLATE.md +168 -0
- package/agents/templates/core/SYSTEM_ANALYSIS_TEMPLATE.md +52 -0
- package/agents/templates/core/TASKS_TEMPLATE.md +104 -0
- package/agents/templates/core/TRACEABILITY_MATRIX_TEMPLATE.md +18 -0
- package/agents/templates/core/WHITEBOARD_DESIGN_TEMPLATE.md +46 -0
- package/agents/templates/data/DATABASE_SCHEMA_TEMPLATE.md +38 -0
- package/agents/templates/data/DATA_PIPELINE_TEMPLATE.md +44 -0
- package/agents/templates/data/ONTOLOGY_TEMPLATE.md +52 -0
- package/agents/templates/industry/ENGINEERING_STANDARDS_REVIEW_TEMPLATE.md +43 -0
- package/agents/templates/industry/FHIR_INTEGRATION_TEMPLATE.md +53 -0
- package/agents/templates/industry/GLOBAL_STANDARDS_AUDIT_TEMPLATE.md +45 -0
- package/agents/templates/industry/IOT_TELEMETRY_TEMPLATE.md +59 -0
- package/agents/templates/industry/TELECOM_API_TEMPLATE.md +50 -0
- package/agents/templates/ops/BENCHMARK_REPORT_TEMPLATE.md +48 -0
- package/agents/templates/ops/CAPACITY_PLAN_TEMPLATE.md +41 -0
- package/agents/templates/ops/COST_OPTIMIZATION_REPORT_TEMPLATE.md +40 -0
- package/agents/templates/ops/DECOMMISSION_PLAN_TEMPLATE.md +102 -0
- package/agents/templates/ops/DEPLOY_CONFIG_TEMPLATE.md +88 -0
- package/agents/templates/ops/INCIDENT_POSTMORTEM_TEMPLATE.md +39 -0
- package/agents/templates/ops/INFRA_PLAN_TEMPLATE.md +37 -0
- package/agents/templates/ops/RELEASE_READINESS_REPORT.md +35 -0
- package/agents/templates/ops/RUNBOOK_TEMPLATE.md +103 -0
- package/agents/templates/ops/TECH_DEBT_TEMPLATE.md +102 -0
- package/agents/templates/product/BUSINESS_CASE_TEMPLATE.md +42 -0
- package/agents/templates/product/CHANGE_MANAGEMENT_PLAN_TEMPLATE.md +68 -0
- package/agents/templates/product/EMPATHY_MAP_TEMPLATE.md +47 -0
- package/agents/templates/product/EXPERIMENT_PLAN_TEMPLATE.md +84 -0
- package/agents/templates/product/GREEN_SOFTWARE_REPORT_TEMPLATE.md +42 -0
- package/agents/templates/product/IDEATION_LOG_TEMPLATE.md +42 -0
- package/agents/templates/product/NFR_TEMPLATE.md +31 -0
- package/agents/templates/product/PRD_TEMPLATE.md +222 -0
- package/agents/templates/product/PROBLEM_STATEMENT_TEMPLATE.md +32 -0
- package/agents/templates/product/REQUIREMENTS_REVIEW_TEMPLATE.md +173 -0
- package/agents/templates/product/SPEC_TEMPLATE.md +259 -0
- package/agents/templates/product/STAKEHOLDER_REGISTER_TEMPLATE.md +127 -0
- package/agents/templates/product/USER_STORY_MAP_TEMPLATE.md +35 -0
- package/agents/templates/product/VISUAL_SPEC_PACKAGE_TEMPLATE.md +207 -0
- package/agents/templates/security/DATASHEET_TEMPLATE.md +95 -0
- package/agents/templates/security/ETHICAL_IMPACT_ASSESSMENT.md +32 -0
- package/agents/templates/security/HAZARD_LOG.md +17 -0
- package/agents/templates/security/MODEL_CARD_TEMPLATE.md +120 -0
- package/agents/templates/security/SAFETY_CASE.md +39 -0
- package/agents/templates/security/SAFETY_POLICY.md +25 -0
- package/agents/templates/security/SECURITY_CHECKLIST.md +157 -0
- package/agents/templates/security/SYSTEM_CARD_TEMPLATE.md +139 -0
- package/agents/templates/security/THREAT_MODEL_TEMPLATE.md +171 -0
- package/bin/install.js +572 -0
- package/docs/CLI_REFERENCE.md +527 -0
- package/docs/INSTALL.md +68 -0
- package/docs/MCP_CONFIGURATIONS.md +1765 -0
- package/docs/PLATFORM_CONTROLS.md +324 -0
- package/docs/POST_INSTALL.md +75 -0
- package/docs/QUICK_COMMANDS.md +131 -0
- package/docs/QUICK_GUIDE.md +914 -0
- package/docs/README_FULL.md +1451 -0
- package/docs/SCHEMA.md +164 -0
- package/docs/V1_RELEASE_CHECKLIST.md +144 -0
- package/docs/VERIFICATION_GUIDE.md +283 -0
- package/docs/adr/0001-record-architecture-decisions.md +26 -0
- package/docs/adr/0002-brain-active-inference-runtime.md +27 -0
- package/docs/adr/0003-additive-only-emitter-schema-evolution.md +33 -0
- package/docs/assets/GABBE.png +0 -0
- package/docs/gabbe.config.example.json +9 -0
- package/docs/reports/duplication-report.md +30 -0
- package/install.ps1 +90 -0
- package/install.sh +89 -0
- package/package.json +49 -0
- package/scripts/init.py +1036 -0
|
@@ -0,0 +1,1451 @@
|
|
|
1
|
+
# GABBE (Generative Architectural Brain Base Engine) - Agentic Software R&D Engineering Kit
|
|
2
|
+
|
|
3
|
+
> **Audience:** users & agents adopting the full GABBE kit. **Scope:** complete reference — skills, templates, guides, modes, setup per language, troubleshooting.
|
|
4
|
+
|
|
5
|
+
## Complete Guide
|
|
6
|
+
|
|
7
|
+
## What is this?
|
|
8
|
+
|
|
9
|
+
- Universal kit for Software and AI coding agents: Claude Code, Cursor, GitHub Copilot, Antigravity/Gemini, Codex.
|
|
10
|
+
- Drop-in context kit that turns any AI coding agent into a governed engineering team for developing software.
|
|
11
|
+
- Based on Software Engineering & Architecture Practices and Procedures.
|
|
12
|
+
- Works for any project type, new or existing, any language, any team size.
|
|
13
|
+
- **Write Once, Run Everywhere**: Skills work on Cursor (`.mdc`), VS Code (`folder/skill`), Claude (`.skill.md`), Gemini.
|
|
14
|
+
- The system features an experimental **Meta-Cognitive Orchestrator "Brain"** (Neurocognitive based architecture derived from Neuroscience, Cognitive Psychology, Epistemology, treating the Software System not as a machine, but as a **Cognitive Entity**), using Active Inference to plan, route, and optimize work.
|
|
15
|
+
- The system features a **Multi-Agent Swarm "Loki" Engineering Team** (30+ specialized agent roles for large projects), providing episodic and semantic memory, project history auditing and checkpoints.
|
|
16
|
+
|
|
17
|
+
It contains:
|
|
18
|
+
- **214 Skills** (specialized capabilities)
|
|
19
|
+
- **100 Templates** (standardized documents)
|
|
20
|
+
- **86 Guides** (language & domain expertise)
|
|
21
|
+
- **36 Personas** (specialized roles)
|
|
22
|
+
- **65 MCP servers** (configuration and guides for AI tools)
|
|
23
|
+
- **Brain Mode** (meta-cognitive orchestration)
|
|
24
|
+
- **Loki Mode** (multi-agent swarm engineering personas team for large projects)
|
|
25
|
+
|
|
26
|
+
> **214 Skills · 100 Templates · 86 Guides · 36 Personas · 50+ MCPs · Loki / Brain Mode CLI**
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Table of Contents
|
|
31
|
+
|
|
32
|
+
1. [What Is This Kit?](#1-what-is-this-kit)
|
|
33
|
+
2. [Brain Mode](#2-brain-mode)
|
|
34
|
+
3. [Quick Start (5 min)](#3-quick-start-5-min)
|
|
35
|
+
4. [Kit Structure Map](#4-kit-structure-map)
|
|
36
|
+
5. [Workflow 1: New Project from Scratch](#5-workflow-1-new-project-from-scratch)
|
|
37
|
+
6. [Workflow 2: Refactoring & Bugfixing Existing Project](#6-workflow-2-refactoring-bugfixing-existing-project)
|
|
38
|
+
7. [Self-Healing + Research Loop](#7-self-healing-research-loop)
|
|
39
|
+
9. [Multi-Agent Systems (MAS)](#9-multi-agent-systems-mas)
|
|
40
|
+
10. [Architecture & Design Patterns](#10-architecture-design-patterns)
|
|
41
|
+
11. [Agentic Patterns (Advanced AI)](#11-agentic-patterns-advanced-ai)
|
|
42
|
+
12. [Testing Strategy](#12-testing-strategy)
|
|
43
|
+
13. [Enterprise Domains (Infra, Data, Integration)](#13-enterprise-domains-infra-data-integration)
|
|
44
|
+
14. [Environment & Deployment (Local/Remote/Cloud)](#14-environment-deployment-localremotecloud)
|
|
45
|
+
15. [Legacy Systems (COBOL, Mainframe)](#15-legacy-systems-cobol-mainframe)
|
|
46
|
+
16. [Future Tech & Adaptive Skills (2026-2030)](#16-future-tech-adaptive-skills-2026-2030)
|
|
47
|
+
17. [System Quality & Evolution (SRE, Performance)](#17-system-quality-evolution-sre-performance)
|
|
48
|
+
18. [System Lifecycle & Traceability](#18-system-lifecycle-traceability)
|
|
49
|
+
19. [Skills Reference](#19-skills-reference)
|
|
50
|
+
20. [Templates Reference](#20-templates-reference)
|
|
51
|
+
21. [MCP Configuration](#21-mcp-configuration)
|
|
52
|
+
22. [Extending the Kit](#22-extending-the-kit)
|
|
53
|
+
23. [Loki Mode (Large Projects)](#23-loki-mode-large-projects)
|
|
54
|
+
24. [Guides by Technology Stack](#24-guides-by-technology-stack)
|
|
55
|
+
25. [Testing & Verification](#25-testing--verification)
|
|
56
|
+
26. [Troubleshooting](#26-troubleshooting)
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## 1. What Is This Kit?
|
|
61
|
+
|
|
62
|
+
This kit gives AI coding agents the **context, skills, memory, and workflows** to act as a reliable software engineering team. It solves **Another Lethal Trifecta** of agentic AI:
|
|
63
|
+
|
|
64
|
+
- **Velocity mismatch** — agents code faster than humans can review, skipping critical steps
|
|
65
|
+
- **Non-determinism** — same prompt, different output every time without guardrails
|
|
66
|
+
- **Cost asymmetry ("context rot")** — wrong architectural decisions compound and become exponentially expensive to fix
|
|
67
|
+
- **Self-Evolution**: Agents rewrite their own prompts (`meta-optimize`) to fix recurring errors.
|
|
68
|
+
- **Adaptive Orchestration**: Loki Mode dynamically injects research/safety phases based on complexity.
|
|
69
|
+
- **Vibe Coding**: Translates high-level aesthetic intents ("Make it pop") into concrete CSS/JS.
|
|
70
|
+
- **Optimal Execution Mandates**: Built-in rules forcing agents to prioritize the best specialized skills, proactively recommend missing MCP servers, and aggressively default to cost & budget optimization unless authorized by a human.
|
|
71
|
+
|
|
72
|
+
The kit enforces **Spec-Driven Development (SDD)**, **Test-Driven Development (TDD)**, **Architecture-Driven Development (ADD)**, and structured **human-in-the-loop checkpoints** — so agents build correct, secure, maintainable software the first time.
|
|
73
|
+
|
|
74
|
+
**Universal Skill Compiler:** `npx gabbe-kit init` (Python-independent), `curl -fsSL …/install.sh | sh`, or `scripts/init.py` automatically configures skills for your specific tool:
|
|
75
|
+
- **VS Code / Copilot**: `.github/skills/<slug>/SKILL.md` (slash commands e.g. `/code-review`).
|
|
76
|
+
- **Cursor**: optimized `.cursor/rules/*.mdc`.
|
|
77
|
+
- **Claude Code**: `.claude/skills/<slug>/SKILL.md` (native skill discovery).
|
|
78
|
+
- **Gemini**: `.gemini/settings.json` + `GEMINI.md`.
|
|
79
|
+
- **Antigravity / OpenCode**: the universal `.agents/skills/<slug>/SKILL.md` tree (+ `opencode.json`).
|
|
80
|
+
- **Zed / Continue / Roo Code / Kilo Code**: root `AGENTS.md` + each tool's rules file.
|
|
81
|
+
|
|
82
|
+
**Compatible with:** Claude Code, Cursor, Windsurf, Cline, Aider, Devin, Gemini, Antigravity, OpenCode, Zed, Continue, Roo Code, Kilo Code, OpenAI/Codex, GitHub Copilot, VS Code — and any tool reading the `AGENTS.md` / agentskills.io standards.
|
|
83
|
+
|
|
84
|
+
**Repositories using this kit should see reduction in agent runtime and token usage** through explicit context, cached decisions, and SDLC memory.
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
## 2. Brain Mode
|
|
89
|
+
|
|
90
|
+
> **"Meta-Cognitive Orchestrator"**
|
|
91
|
+
|
|
92
|
+
The system features a **Brain Mode** that supersedes standard execution. It uses **Active Inference** to minimize project risk and intelligently routes tasks to local and remote models.
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
# Activate Brain Mode
|
|
96
|
+
/brain activate "Build a SaaS platform"
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
### Key Capabilities
|
|
100
|
+
- **Active Inference Loop**: Continuously compares "Expected State" vs "Actual State".
|
|
101
|
+
- **Dynamic Cost Routing**: Routes simple tasks to **Local LLMs** and complex ones to **Remote SOTA Models**.
|
|
102
|
+
- **Episodic Memory**: Learns from past failures and successes across projects.
|
|
103
|
+
|
|
104
|
+
Read more in [AGENTS.md](../agents/AGENTS.md).
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
## 3. Quick Start (5 min)
|
|
109
|
+
|
|
110
|
+
```bash
|
|
111
|
+
# 1. Run the Interactive Setup Wizard
|
|
112
|
+
python3 scripts/init.py
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
**2. Feed the Mission**
|
|
116
|
+
- The script generates `BOOTSTRAP_MISSION.md` (or `SETUP_MISSION.md` if dynamic setup is disabled) in your root.
|
|
117
|
+
- **Copy its content** and paste it into your AI Agent's chat window.
|
|
118
|
+
- This aligns the agent with your project context immediately.
|
|
119
|
+
|
|
120
|
+
**3. Verify Context**
|
|
121
|
+
- Open `agents/AGENTS.md` and check the `Tech Stack` section.
|
|
122
|
+
- Open `agents/CONSTITUTION.md` and review project rules.
|
|
123
|
+
|
|
124
|
+
**4. Git Tracking (Important)**
|
|
125
|
+
- To keep the initial structure of `agents/memory/` and `project/` in your repository but prevent Git from tracking the continuous autonomous modifications your agents will make to them locally, run:
|
|
126
|
+
```bash
|
|
127
|
+
git ls-files agents/memory/ project/ | xargs git update-index --skip-worktree
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## 3.1. GABBE CLI (experimental)
|
|
133
|
+
|
|
134
|
+
GABBE has a **Zero-Dependency CLI** (`gabbe`) CLI which powers the "Hybrid Mode". It bridges the gap between flexible Markdown files and a robust SQLite database.
|
|
135
|
+
It's an experimental work-in-progress and you can do without the whole package only with the rest of the kit.
|
|
136
|
+
|
|
137
|
+
### Prerequisites
|
|
138
|
+
- Python 3.8+
|
|
139
|
+
- **LLM API Key**: For Brain/Route features, set `GABBE_API_KEY` (OpenAI-compatible).
|
|
140
|
+
|
|
141
|
+
**Environment Variables** (full reference in [CLI_REFERENCE.md](CLI_REFERENCE.md#environment-variables)):
|
|
142
|
+
|
|
143
|
+
| Variable | Default | Description |
|
|
144
|
+
|---|---|---|
|
|
145
|
+
| `GABBE_API_URL` | `https://api.openai.com/v1/chat/completions` | OpenAI-compatible endpoint |
|
|
146
|
+
| `GABBE_API_KEY` | *(required for LLM features)* | Bearer token for the LLM API |
|
|
147
|
+
| `GABBE_API_MODEL` | `gpt-4o` | Model name sent in API requests |
|
|
148
|
+
| `GABBE_LLM_TEMPERATURE` | `0.7` | Sampling temperature (0.0–1.0) |
|
|
149
|
+
| `GABBE_LLM_TIMEOUT` | `30` | HTTP timeout in seconds |
|
|
150
|
+
| `GABBE_ROUTE_THRESHOLD` | `50` | Complexity score above which prompts route REMOTE |
|
|
151
|
+
| `GABBE_MAX_COST_USD` | `5.0` | Maximum cost (USD) budget per run |
|
|
152
|
+
| `GABBE_MAX_TOKENS_PER_RUN` | `100000` | Maximum token limit per run |
|
|
153
|
+
| `GABBE_MAX_TOOL_CALLS_PER_RUN` | `50` | Maximum tool calls per run |
|
|
154
|
+
| `GABBE_MAX_ITERATIONS` | `25` | Maximum brain loop iterations per run |
|
|
155
|
+
| `GABBE_MAX_WALL_TIME` | `300` | Maximum wall-clock time per run (seconds) |
|
|
156
|
+
| `GABBE_MAX_RECURSION_DEPTH` | `5` | Maximum agent recursion depth |
|
|
157
|
+
| `GABBE_MAX_RETRIES_PER_TOOL` | `3` | Maximum retries per tool call |
|
|
158
|
+
| `GABBE_LLM_MAX_RETRIES` | `3` | Number of retry attempts for LLM HTTP calls |
|
|
159
|
+
| `GABBE_LOG_LEVEL` | `INFO` | Logging level (`DEBUG`, `INFO`, `WARNING`, `ERROR`) |
|
|
160
|
+
| `GABBE_POLICY_FILE` | `project/policies.yml` | Path to YAML policy file for tool access control |
|
|
161
|
+
| `GABBE_ESCALATION_MODE` | `cli` | Escalation mode: `cli` (interactive), `file` (pause), `silent` (auto-reject) |
|
|
162
|
+
| `GABBE_SUBPROCESS_TIMEOUT` | `300` | Timeout for verify shell commands (seconds) |
|
|
163
|
+
| `GABBE_MCP_TOKEN` | *(unset)* | If set, MCP clients must provide this token to authenticate |
|
|
164
|
+
| `GABBE_MCP_ALLOWED_COMMANDS` | *(unset)* | Comma-separated list of executables permitted via MCP `run_command` |
|
|
165
|
+
| `GABBE_OTEL_ENABLED` | `false` | Enable OpenTelemetry tracing |
|
|
166
|
+
|
|
167
|
+
### Installation
|
|
168
|
+
The CLI is a Python package.
|
|
169
|
+
|
|
170
|
+
```bash
|
|
171
|
+
# 1. Install locally (Recommended)
|
|
172
|
+
pip install -e .
|
|
173
|
+
|
|
174
|
+
# 2. Verify installation
|
|
175
|
+
gabbe --help
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
### Core Commands
|
|
179
|
+
| Command | Description |
|
|
180
|
+
|---|---|
|
|
181
|
+
| `gabbe init` | Initialize the SQLite Database (Run this after `python scripts/init.py`). |
|
|
182
|
+
| `gabbe sync` | **Hybrid Sync**: Bidirectional sync between `project/TASKS.md` and SQLite DB. |
|
|
183
|
+
| `gabbe verify`| **Enforcer**: programmable integrity check (files, tests, lint). |
|
|
184
|
+
| `gabbe verify --chaos` | **Resilience**: fault-injection self-checks (fail-closed tool, hard-stop, PII routing, escalation). |
|
|
185
|
+
| `gabbe eval` | **Skill evals**: deterministic self-check; `--live` scores skill outputs via the model. |
|
|
186
|
+
| `gabbe doctor` | **Autodetect**: OS/arch, runtimes, installed agents + post-install MCP next-steps. |
|
|
187
|
+
| `gabbe update` / `gabbe uninstall` | **Reversible install**: additive refresh / manifest-backed removal (`--dry-run`, `--purge`, `--global`, `--dir`). |
|
|
188
|
+
| `gabbe status`| **Dashboard**: Visualizes project phase and task progress. |
|
|
189
|
+
| `gabbe brain` | **Meta-Cognition**: Activates Active Inference loop or Evolutionary Prompt Optimization (Requires API Key). |
|
|
190
|
+
| `gabbe route` | **Cost Router**: Arbitrates between Local and Remote LLMs based on task complexity (Requires API Key). |
|
|
191
|
+
| `gabbe forecast`| **Strategic Forecast**: Projects remaining work cost and tokens based on historical run data. |
|
|
192
|
+
| `gabbe serve-mcp` | **MCP Gateway**: Zero-dependency JSON-RPC Model Context Protocol server for standalone agents to access tools safely. |
|
|
193
|
+
| `gabbe runs [--status STATUS] [--limit N]` | **Run History**: List recent agent runs with status, cost, and timestamps. |
|
|
194
|
+
| `gabbe audit <run-id> [--format json\|table]` | **Audit Trace**: Display structured span-level audit trace for a past run. |
|
|
195
|
+
| `gabbe replay <run-id> [--from-step N]` | **Deterministic Replay**: Replay a past run from its checkpoints. |
|
|
196
|
+
| `gabbe resume <run-id>` | **Escalation Resume**: Approve or reject pending escalations for a paused run. |
|
|
197
|
+
| `gabbe registry publish [--out DIR]` | **Publish Skills**: Export skills as a publish-ready agentskills.io bundle (manifest + agent-card) for universal registries. |
|
|
198
|
+
| `gabbe registry add <source>` | **Import Skills**: Draw an external skill/bundle (validated + security-scanned + namespaced). |
|
|
199
|
+
| `gabbe setup` | **Install Wizard**: Wire the kit into your coding agents (also `npx gabbe-kit init`). |
|
|
200
|
+
|
|
201
|
+
### Platform Control Layer
|
|
202
|
+
The experimental `gabbe` CLI supports a **platform control layer**. It covers budget enforcement, cost and token controls, hard stops, policy rules, the tool gateway, audit tracing, human escalation, and deterministic replay. Detailed documentation is available in [`PLATFORM_CONTROLS.md`](PLATFORM_CONTROLS.md).
|
|
203
|
+
|
|
204
|
+
### Architecture
|
|
205
|
+
GABBE 2.0 uses a **Hybrid Architecture** where agents and humans interact via Markdown, but the system of record is SQLite.
|
|
206
|
+
|
|
207
|
+
```mermaid
|
|
208
|
+
graph TD
|
|
209
|
+
subgraph User["User (Legacy Flow)"]
|
|
210
|
+
Edit[Edit project/TASKS.md]
|
|
211
|
+
end
|
|
212
|
+
|
|
213
|
+
subgraph CLI["GABBE CLI (pip installed)"]
|
|
214
|
+
Sync[gabbe sync]
|
|
215
|
+
Verify[gabbe verify]
|
|
216
|
+
Brain[gabbe brain]
|
|
217
|
+
Router[gabbe route]
|
|
218
|
+
Forecast[gabbe forecast]
|
|
219
|
+
MCP[gabbe serve-mcp]
|
|
220
|
+
end
|
|
221
|
+
|
|
222
|
+
subgraph Storage["Hybrid Memory"]
|
|
223
|
+
MD[Markdown Files]
|
|
224
|
+
DB[(SQLite state.db)]
|
|
225
|
+
end
|
|
226
|
+
|
|
227
|
+
User -->|Manual Edits| MD
|
|
228
|
+
MD <-->|Bi-Directional| Sync
|
|
229
|
+
Sync <--> DB
|
|
230
|
+
Brain -->|Read/Write| DB
|
|
231
|
+
Verify -->|Check| MD
|
|
232
|
+
Verify -->|Check| DB
|
|
233
|
+
Forecast -->|Analyze| DB
|
|
234
|
+
MCP -->|Write Telemetry| DB
|
|
235
|
+
```
|
|
236
|
+
|
|
237
|
+
### Text Overview (ASCII)
|
|
238
|
+
|
|
239
|
+
```text
|
|
240
|
+
[User] --(Manual Edits)--> [Markdown Files] <--(Bi-Directional)--> [gabbe sync] <--> [(SQLite state.db)]
|
|
241
|
+
^ ^
|
|
242
|
+
[gabbe brain] --(Read/Write)-----------------------------------------------------------+ |
|
|
243
|
+
[gabbe verify] --(Check)--> [Markdown Files] |
|
|
244
|
+
[gabbe verify] --(Check)----------------------------------------------------------------------+
|
|
245
|
+
[gabbe forecast] --(Analyze)------------------------------------------------------------------+
|
|
246
|
+
[gabbe serve-mcp] --(Write Telemetry)---------------------------------------------------------+
|
|
247
|
+
```
|
|
248
|
+
|
|
249
|
+
### How to Use
|
|
250
|
+
|
|
251
|
+
#### Setup
|
|
252
|
+
```bash
|
|
253
|
+
# 1. Generate Context Configs
|
|
254
|
+
python3 scripts/init.py
|
|
255
|
+
|
|
256
|
+
# 2. Initialize Database
|
|
257
|
+
gabbe init
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
#### Daily Workflow
|
|
261
|
+
```bash
|
|
262
|
+
# Check status
|
|
263
|
+
gabbe status
|
|
264
|
+
|
|
265
|
+
# Sync tasks (manual edits)
|
|
266
|
+
gabbe sync
|
|
267
|
+
|
|
268
|
+
# Optimize a skill (Requires GABBE_API_KEY)
|
|
269
|
+
gabbe brain evolve --skill tdd-cycle
|
|
270
|
+
```
|
|
271
|
+
|
|
272
|
+
#### Verification
|
|
273
|
+
```bash
|
|
274
|
+
gabbe verify
|
|
275
|
+
```
|
|
276
|
+
|
|
277
|
+
---
|
|
278
|
+
|
|
279
|
+
## 🚀 Common Actions (Copy-Paste Prompts)
|
|
280
|
+
|
|
281
|
+
### Strategy & Ideation (Step 0)
|
|
282
|
+
```
|
|
283
|
+
"Use business-case/strategy skills to validate exactly why we are building [description] and who it is for."
|
|
284
|
+
```
|
|
285
|
+
|
|
286
|
+
### New Project from Scratch
|
|
287
|
+
```
|
|
288
|
+
"Read AGENTS.md. I want to build [description]. Start with spec-writer skill."
|
|
289
|
+
```
|
|
290
|
+
**Flow:** Strategy → Spec → Design → Tasks → TDD Implementation → Security → Deploy
|
|
291
|
+
|
|
292
|
+
### Resume Existing Project
|
|
293
|
+
```
|
|
294
|
+
"Read AGENTS.md and agents/memory/PROJECT_STATE.md. Resume the project."
|
|
295
|
+
```
|
|
296
|
+
|
|
297
|
+
### Fix a Bug
|
|
298
|
+
```
|
|
299
|
+
"Read AGENTS.md. Bug: [description]. Use debug skill with TDD."
|
|
300
|
+
```
|
|
301
|
+
**Flow:** Reproduce → Root Cause → Failing Test → Fix → Green → Regression Check
|
|
302
|
+
|
|
303
|
+
### Refactor / Pay Tech Debt
|
|
304
|
+
```
|
|
305
|
+
"Use tech-debt skill on [directory]. Then refactor the top-priority item."
|
|
306
|
+
```
|
|
307
|
+
|
|
308
|
+
### Security Audit
|
|
309
|
+
```
|
|
310
|
+
"Run security-audit skill on the entire codebase."
|
|
311
|
+
```
|
|
312
|
+
|
|
313
|
+
### Architecture Review
|
|
314
|
+
```
|
|
315
|
+
"Run arch-review skill. Check for SOLID violations and coupling."
|
|
316
|
+
```
|
|
317
|
+
```
|
|
318
|
+
"Use the performant-nodejs skill to audit the current Node.js architecture for scalability bottlenecks and propose optimizations."
|
|
319
|
+
```
|
|
320
|
+
```
|
|
321
|
+
"Use the performant-laravel skill to audit the current Laravel architecture for scalability bottlenecks and propose optimizations."
|
|
322
|
+
```
|
|
323
|
+
```
|
|
324
|
+
"Use the performant-python skill to audit the current Python architecture for scalability bottlenecks and propose optimizations."
|
|
325
|
+
```
|
|
326
|
+
```
|
|
327
|
+
"Use the performant-go skill to audit the current Go architecture for scalability bottlenecks and propose optimizations."
|
|
328
|
+
```
|
|
329
|
+
```
|
|
330
|
+
"Use the performant-ai skill to audit the current AI/LLM architecture for latency and cost bottlenecks."
|
|
331
|
+
```
|
|
332
|
+
|
|
333
|
+
### Software Engineering & System Architecture
|
|
334
|
+
```
|
|
335
|
+
"Act as a Principal Staff Engineer. Review the codebase in [directory] and generate a C4 system architecture diagram (Context and Container levels). Identify any bottlenecks and propose scaling strategies."
|
|
336
|
+
```
|
|
337
|
+
```
|
|
338
|
+
"Use the design-patterns and domain-model skills. We are building a [feature segment]. Propose the optimum architecture pattern (e.g. Event-driven, CQRS, Hexagonal) and define the core domain entities."
|
|
339
|
+
```
|
|
340
|
+
|
|
341
|
+
### Vibe-Coding (Creative Frontend)
|
|
342
|
+
```
|
|
343
|
+
"Use the vibe-coding skill. Build a [component/page] using [framework]. I want it to feel [aesthetic, e.g. glassmorphism, cyberpunk, sleek corporate]. Include micro-animations and smooth transitions. Prioritize visual WOW over generic utility."
|
|
344
|
+
```
|
|
345
|
+
|
|
346
|
+
### Activate Brain Mode (Complex Goals)
|
|
347
|
+
```
|
|
348
|
+
"Activate Brain Mode. Goal: [build X / migrate Y / solve Z]."
|
|
349
|
+
```
|
|
350
|
+
Uses Active Inference to plan, route between local/remote models, and learn from past outcomes.
|
|
351
|
+
|
|
352
|
+
### Activate Loki Mode (Large Projects)
|
|
353
|
+
|
|
354
|
+
**Using the CLI:**
|
|
355
|
+
> `gabbe brain activate` (Loki may be triggered autonomously by the Brain based on context cost).
|
|
356
|
+
Or activate the swarm skill explicitly:
|
|
357
|
+
> Activate `agents/skills/brain/loki-mode.skill.md` with your goal.
|
|
358
|
+
|
|
359
|
+
**Using Pure Agent Mode (No CLI):**
|
|
360
|
+
> "Activate `agents/skills/brain/loki-mode.skill.md`. Goal: [build X]. Do not ask me for permission unless you hit a mandatory Human Approval Gate or a task requires True A2A Delegation."
|
|
361
|
+
|
|
362
|
+
|
|
363
|
+
```
|
|
364
|
+
Multi-agent swarm with 30+ specialized personas for projects >5 features or >20 files.
|
|
365
|
+
```
|
|
366
|
+
|
|
367
|
+
---
|
|
368
|
+
|
|
369
|
+
**After Setup - Common Triggers:**
|
|
370
|
+
|
|
371
|
+
**New Project:**
|
|
372
|
+
> "Read AGENTS.md. I want to build [description]. Start with spec-writer skill."
|
|
373
|
+
|
|
374
|
+
**Resuming:**
|
|
375
|
+
> "Read AGENTS.md and agents/memory/PROJECT_STATE.md. Resume the project."
|
|
376
|
+
|
|
377
|
+
**Fixing a Bug:**
|
|
378
|
+
> "Read AGENTS.md. There's a bug: [description]. Use debug skill and fix it with TDD."
|
|
379
|
+
> *VS Code users: Type `/debug`*
|
|
380
|
+
|
|
381
|
+
---
|
|
382
|
+
|
|
383
|
+
## 4. Kit Structure Map
|
|
384
|
+
|
|
385
|
+
```mermaid
|
|
386
|
+
graph TB
|
|
387
|
+
subgraph "Agent Context Layer"
|
|
388
|
+
A[AGENTS.md<br/>Universal config template] --> B[CONSTITUTION.md<br/>Immutable project law]
|
|
389
|
+
A --> C[skills/00-index.md<br/>Skills registry]
|
|
390
|
+
A --> D[guides/<br/>Language-specific guides]
|
|
391
|
+
end
|
|
392
|
+
subgraph "Agent Capability Layer"
|
|
393
|
+
C --> S1[Core Skills<br/>code-review, tdd, refactor, debug]
|
|
394
|
+
C --> S2[Security Skills<br/>security-audit, threat-model, privacy]
|
|
395
|
+
C --> S3[Research + Self-Heal<br/>research, self-heal, knowledge-gap]
|
|
396
|
+
C --> S4[SDLC Skills<br/>session-resume, sdlc-checkpoint, integrity-check]
|
|
397
|
+
end
|
|
398
|
+
subgraph "Memory Layer"
|
|
399
|
+
M1[agents/memory/PROJECT_STATE.md<br/>Current SDLC phase] --> M2[agents/memory/AUDIT_LOG.md<br/>Append-only decision history]
|
|
400
|
+
M2 --> M3[agents/memory/episodic/<br/>Per-session decision logs]
|
|
401
|
+
M3 --> M4[agents/memory/episodic/SESSION_SNAPSHOT/<br/>Per-milestone snapshots]
|
|
402
|
+
M5[agents/memory/CONTINUITY.md<br/>Past failures - checked every session] --> M6[agents/memory/semantic/<br/>Crystallized project knowledge]
|
|
403
|
+
end
|
|
404
|
+
subgraph "Orchestration Layer — Large Projects"
|
|
405
|
+
L[agents/skills/brain/loki-mode.skill.md<br/>Master orchestration] --> P[agents/personas/<br/>30+ role-based agent personas]
|
|
406
|
+
L --> M1
|
|
407
|
+
end
|
|
408
|
+
subgraph "Templates Layer"
|
|
409
|
+
T[templates/<br/>60+ fill-in-the-blank docs]
|
|
410
|
+
end
|
|
411
|
+
```
|
|
412
|
+
|
|
413
|
+
---
|
|
414
|
+
|
|
415
|
+
## 5. Workflow 1: New Project from Scratch
|
|
416
|
+
|
|
417
|
+
### Required Minimum
|
|
418
|
+
|
|
419
|
+
| SDLC Gate | Required | Optional |
|
|
420
|
+
|---|---|---|
|
|
421
|
+
| **S01 Requirements** | PRD.md with EARS syntax, human approval | User stories, wireframes, CONSTITUTION.md articles |
|
|
422
|
+
| **S02 Design** | Architecture decision + AGENTS.md update | C4 model, formal ADR, threat model (required for security features) |
|
|
423
|
+
| **S03 Specification** | SPEC_TEMPLATE.md, API contracts | Feature flags, rollout plan |
|
|
424
|
+
| **S04 Tasks** | TASKS_TEMPLATE.md, 15-min decomposition | Epic planning, story points |
|
|
425
|
+
| **S05 Implementation** | TDD (test first), RARV cycle, audit log | Browser-TDD (frontend only), pair-agent review |
|
|
426
|
+
| **S06 Testing** | Unit tests >99% coverage, integration tests | E2E tests, load tests, visual regression |
|
|
427
|
+
| **S07 Security** | SECURITY_CHECKLIST.md, `npm audit` clean, `compliance-review` | DAST, penetration test, formal compliance review |
|
|
428
|
+
| **S08 Review** | Human code review | orch-judge EARS compliance check |
|
|
429
|
+
| **S09 Staging** | Smoke tests | Performance benchmarks, accessibility audit |
|
|
430
|
+
| **S10 Production** | Rollback plan, monitoring | Canary deployment, feature flags |
|
|
431
|
+
|
|
432
|
+
### Full SDLC Flow
|
|
433
|
+
|
|
434
|
+
```mermaid
|
|
435
|
+
flowchart TD
|
|
436
|
+
A([Start: User Goal]) --> B[Read AGENTS.md + CONSTITUTION.md]
|
|
437
|
+
B --> C{Project size?}
|
|
438
|
+
C -->|Small/Medium| D[Single Agent Mode]
|
|
439
|
+
C -->|Large/Complex| E[Loki Swarm Mode]
|
|
440
|
+
|
|
441
|
+
D --> F[spec-writer.skill → PRD.md + EARS]
|
|
442
|
+
E --> F
|
|
443
|
+
|
|
444
|
+
F --> G{Human approves spec?}
|
|
445
|
+
G -->|No| F
|
|
446
|
+
G -->|Yes| H[sdlc-checkpoint S01]
|
|
447
|
+
|
|
448
|
+
H --> I[adr-writer.skill + threat-model.skill]
|
|
449
|
+
I --> J[C4 Architecture + PLAN.md]
|
|
450
|
+
J --> K{Human approves design?}
|
|
451
|
+
K -->|No| I
|
|
452
|
+
K -->|Yes| L[sdlc-checkpoint S02]
|
|
453
|
+
|
|
454
|
+
L --> M[project/TASKS.md decomposition — 15-min rule]
|
|
455
|
+
M --> N[sdlc-checkpoint S03/S04]
|
|
456
|
+
|
|
457
|
+
N --> O[Implementation Loop]
|
|
458
|
+
O --> O1[RARV Cycle per task]
|
|
459
|
+
O1 --> O2{Tests pass?}
|
|
460
|
+
O2 -->|No| O3[self-heal.skill max 5×]
|
|
461
|
+
O3 --> O2
|
|
462
|
+
O2 -->|Yes| O4[audit-trail.skill log]
|
|
463
|
+
O4 --> O5{All tasks done?}
|
|
464
|
+
O5 -->|No| O1
|
|
465
|
+
O5 -->|Yes| P[sdlc-checkpoint S05]
|
|
466
|
+
|
|
467
|
+
P --> Q[integrity-check.skill — 8 dimensions]
|
|
468
|
+
Q --> R[sdlc-checkpoint S06]
|
|
469
|
+
R --> S[security-audit.skill + compliance-review.skill + SECURITY_CHECKLIST]
|
|
470
|
+
S --> T[sdlc-checkpoint S07]
|
|
471
|
+
T --> U{Human review}
|
|
472
|
+
U -->|Changes needed| O
|
|
473
|
+
U -->|Approved| V[sdlc-checkpoint S08]
|
|
474
|
+
V --> W[deployment.skill → Staging]
|
|
475
|
+
W --> X[sdlc-checkpoint S09]
|
|
476
|
+
X --> Y[Production Deploy]
|
|
477
|
+
Y --> Z([sdlc-checkpoint S10 — COMPLETE])
|
|
478
|
+
|
|
479
|
+
style A fill:#4CAF50,color:#fff
|
|
480
|
+
style Z fill:#4CAF50,color:#fff
|
|
481
|
+
style G fill:#FF9800,color:#fff
|
|
482
|
+
style K fill:#FF9800,color:#fff
|
|
483
|
+
style U fill:#FF9800,color:#fff
|
|
484
|
+
```
|
|
485
|
+
|
|
486
|
+
### Step-by-Step Instructions
|
|
487
|
+
|
|
488
|
+
**Step 0 — Strategy (Optional)**
|
|
489
|
+
```
|
|
490
|
+
Tell agent: "Use business-case/strategy skills to validate the goals."
|
|
491
|
+
Agent produces: BUSINESS_CASE.md or EMPATHY_MAP.md or similar strategy docs
|
|
492
|
+
You review: The 'Why' and the 'Who' before moving to 'What'
|
|
493
|
+
Approve: "Approved. Move to Step 1 Requirements."
|
|
494
|
+
```
|
|
495
|
+
|
|
496
|
+
**Step 1 — Requirements (S01)**
|
|
497
|
+
```
|
|
498
|
+
Tell agent: "Use spec-writer skill. Build [your goal]."
|
|
499
|
+
Agent produces: PRD.md using EARS syntax (templates/product/PRD_TEMPLATE.md)
|
|
500
|
+
(Optional) Tell agent: "Use visual-specs skill to process these whiteboard photos."
|
|
501
|
+
Agent produces: VISUAL_SPEC_PACKAGE_TEMPLATE.md + diagrams
|
|
502
|
+
You review: Check that all requirements are verifiable predicates and visual specs match intent.
|
|
503
|
+
Approve: "Approved. Create SDLC checkpoint S01."
|
|
504
|
+
```
|
|
505
|
+
|
|
506
|
+
**Step 2 — Design (S02)**
|
|
507
|
+
```
|
|
508
|
+
Agent produces: PLAN.md + C4 architecture diagram + ADRs for major decisions
|
|
509
|
+
Agent runs: threat-model.skill for any auth/data storage features
|
|
510
|
+
You review: Architecture decisions, data flow, security mitigations
|
|
511
|
+
Approve: "Approved. Create SDLC checkpoint S02."
|
|
512
|
+
```
|
|
513
|
+
|
|
514
|
+
**Step 3 — Specification & Tasks (S03/S04)**
|
|
515
|
+
```
|
|
516
|
+
Agent produces: SPEC_TEMPLATE.md with API contracts + TASKS_TEMPLATE.md
|
|
517
|
+
Each task must: Be achievable in ~15 minutes, have testable acceptance criteria
|
|
518
|
+
You review: Coverage of all PRD requirements in tasks
|
|
519
|
+
Approve: "Approved. Create SDLC checkpoints S03 and S04."
|
|
520
|
+
```
|
|
521
|
+
|
|
522
|
+
**Step 4 — Implementation Loop (S05)**
|
|
523
|
+
```
|
|
524
|
+
For each task, agent:
|
|
525
|
+
1. Reads task + AGENTS.md + CONTINUITY.md (past failures)
|
|
526
|
+
2. Detects knowledge gaps → invokes research.skill if needed
|
|
527
|
+
3. Writes failing test FIRST (TDD Red)
|
|
528
|
+
4. Implements minimal code to pass test (TDD Green)
|
|
529
|
+
5. Refactors while keeping tests green (TDD Refactor)
|
|
530
|
+
6. Runs: tests + lint + typecheck + agentic-linter boundary check
|
|
531
|
+
7. Logs to AUDIT_LOG.md
|
|
532
|
+
8. Marks task DONE in project/TASKS.md
|
|
533
|
+
```
|
|
534
|
+
|
|
535
|
+
**Steps 5-10 — Quality, Security, Deploy**
|
|
536
|
+
```
|
|
537
|
+
Tell agent: "Run integrity-check skill" → 8-dimension verification
|
|
538
|
+
Tell agent: "Run security-audit and compliance-review skills" → OWASP checks + compliance checks
|
|
539
|
+
You review code → Human approval → Staging deploy → Production
|
|
540
|
+
```
|
|
541
|
+
|
|
542
|
+
---
|
|
543
|
+
|
|
544
|
+
## 6. Workflow 2: Refactoring & Bugfixing Existing Project
|
|
545
|
+
|
|
546
|
+
### Full Flow
|
|
547
|
+
|
|
548
|
+
```mermaid
|
|
549
|
+
flowchart TD
|
|
550
|
+
A([Start: Existing Project]) --> B[session-resume.skill]
|
|
551
|
+
B --> B1{Has agents/memory?}
|
|
552
|
+
B1 -->|Yes — resuming| C[Load all memory + project state]
|
|
553
|
+
B1 -->|No — first time| D[Initialize kit]
|
|
554
|
+
|
|
555
|
+
D --> D1[setup-context.sh]
|
|
556
|
+
D1 --> D2[Adapt AGENTS.md]
|
|
557
|
+
D2 --> D3[Run audit skills]
|
|
558
|
+
|
|
559
|
+
C --> E[integrity-check.skill]
|
|
560
|
+
D3 --> E
|
|
561
|
+
|
|
562
|
+
E --> F{What type of work?}
|
|
563
|
+
|
|
564
|
+
F -->|Bug Fix| G[BUG_REPORT_TEMPLATE + debug.skill]
|
|
565
|
+
G --> G1[Reproduce → Root cause → TDD Red]
|
|
566
|
+
G1 --> G2[tdd-cycle.skill — write test FIRST]
|
|
567
|
+
G2 --> G3[Fix → Green → Refactor]
|
|
568
|
+
G3 --> G4[self-heal if stuck]
|
|
569
|
+
G4 --> G5[audit-trail.skill]
|
|
570
|
+
|
|
571
|
+
F -->|Tech Debt| H[tech-debt.skill]
|
|
572
|
+
H --> H1[TECH_DEBT_TEMPLATE prioritized backlog]
|
|
573
|
+
H1 --> H2[refactor.skill per item]
|
|
574
|
+
H2 --> H3[agentic-linter check after each]
|
|
575
|
+
|
|
576
|
+
F -->|Architecture Debt| I[arch-debt.skill]
|
|
577
|
+
I --> I1[Coupling analysis + violations]
|
|
578
|
+
I1 --> I2[ADR for migration approach]
|
|
579
|
+
I2 --> I3[Strangler Fig or modularization]
|
|
580
|
+
I3 --> I4[agentic-linter gates each PR]
|
|
581
|
+
|
|
582
|
+
F -->|Security| J[security-audit.skill + compliance-review.skill + threat-model]
|
|
583
|
+
J --> J1[SECURITY_CHECKLIST.md]
|
|
584
|
+
J1 --> J2[privacy-audit.skill if PII involved]
|
|
585
|
+
J2 --> J3[legal-review.skill if regulated]
|
|
586
|
+
|
|
587
|
+
F -->|Performance| K[performance-audit.skill]
|
|
588
|
+
K --> K1[Profile → bottlenecks → N+1 check]
|
|
589
|
+
K1 --> K2[Fix with test guard — no regressions]
|
|
590
|
+
|
|
591
|
+
G5 --> L[sdlc-checkpoint]
|
|
592
|
+
H3 --> L
|
|
593
|
+
I4 --> L
|
|
594
|
+
J3 --> L
|
|
595
|
+
K2 --> L
|
|
596
|
+
|
|
597
|
+
L --> M[integrity-check.skill — final verify]
|
|
598
|
+
M --> N{All green?}
|
|
599
|
+
N -->|No| F
|
|
600
|
+
N -->|Yes| O[git-workflow.skill → PR]
|
|
601
|
+
O --> P([Human review + merge])
|
|
602
|
+
|
|
603
|
+
style A fill:#2196F3,color:#fff
|
|
604
|
+
style P fill:#4CAF50,color:#fff
|
|
605
|
+
style F fill:#FF9800,color:#fff
|
|
606
|
+
```
|
|
607
|
+
|
|
608
|
+
### First-Time Setup on Existing Project
|
|
609
|
+
|
|
610
|
+
```bash
|
|
611
|
+
# 1. Copy kit to project root
|
|
612
|
+
cp -r ~/agents/ ./
|
|
613
|
+
|
|
614
|
+
# 2. Wire up context
|
|
615
|
+
agents/setup-context.sh
|
|
616
|
+
|
|
617
|
+
# 3. Adapt AGENTS.md
|
|
618
|
+
# - Set tech stack, test commands, lint commands
|
|
619
|
+
# - Add existing architecture constraints
|
|
620
|
+
# - Document known tech debt areas
|
|
621
|
+
|
|
622
|
+
# 4. Initialize memory
|
|
623
|
+
# Agent: "Initialize project memory. Run integrity-check skill on current codebase."
|
|
624
|
+
```
|
|
625
|
+
|
|
626
|
+
### Bug Fix Flow (step-by-step)
|
|
627
|
+
|
|
628
|
+
```
|
|
629
|
+
1. Fill templates/core/BUG_REPORT_TEMPLATE.md with reproduction steps
|
|
630
|
+
2. Tell agent: "Use debug skill. Bug: [description]. BUG_REPORT_TEMPLATE.md is filled."
|
|
631
|
+
3. Agent: reproduces → root cause → writes FAILING TEST first
|
|
632
|
+
4. Agent: implements fix → verifies test is now GREEN
|
|
633
|
+
5. Agent: runs full test suite (no regressions), lint, typecheck
|
|
634
|
+
6. Agent: logs to AUDIT_LOG.md, creates git-workflow PR
|
|
635
|
+
7. You: review PR
|
|
636
|
+
```
|
|
637
|
+
|
|
638
|
+
### Tech Debt Flow (step-by-step)
|
|
639
|
+
|
|
640
|
+
```
|
|
641
|
+
1. Tell agent: "Use tech-debt skill on [directory or whole project]."
|
|
642
|
+
2. Agent: scans for TODOs, complexity > 10, duplication, stale deps
|
|
643
|
+
3. Agent: fills TECH_DEBT_TEMPLATE.md with Impact×Effort matrix
|
|
644
|
+
4. You: review and prioritize the backlog
|
|
645
|
+
5. Tell agent: "Refactor [debt item] using refactor skill. Keep all tests green."
|
|
646
|
+
6. Agent: runs agentic-linter after each refactor to verify boundaries
|
|
647
|
+
```
|
|
648
|
+
|
|
649
|
+
---
|
|
650
|
+
|
|
651
|
+
## 7. Self-Healing + Research Loop
|
|
652
|
+
|
|
653
|
+
```mermaid
|
|
654
|
+
flowchart LR
|
|
655
|
+
A[Task assigned] --> B{Knowledge gap?}
|
|
656
|
+
B -->|Yes| C[knowledge-gap.skill]
|
|
657
|
+
C --> D[research.skill]
|
|
658
|
+
D --> E{Authoritative source found?}
|
|
659
|
+
E -->|Yes| F[Store in semantic memory]
|
|
660
|
+
E -->|No| G[Escalate to human]
|
|
661
|
+
F --> H[Proceed with task]
|
|
662
|
+
B -->|No| H
|
|
663
|
+
H --> I{Verification passes?}
|
|
664
|
+
I -->|Yes| J[audit-trail log → Done]
|
|
665
|
+
I -->|No| K[self-heal.skill]
|
|
666
|
+
K --> L{Attempt < 5?}
|
|
667
|
+
L -->|Yes| M[Diagnose + re-research if needed]
|
|
668
|
+
M --> H
|
|
669
|
+
L -->|No| N[Human escalation report]
|
|
670
|
+
N --> O[orch-coordinator ticket]
|
|
671
|
+
O --> P([Human decision])
|
|
672
|
+
P --> H
|
|
673
|
+
```
|
|
674
|
+
|
|
675
|
+
---
|
|
676
|
+
|
|
677
|
+
---
|
|
678
|
+
|
|
679
|
+
## 8. Cognitive Architecture Integration (Evolution & Healing)
|
|
680
|
+
|
|
681
|
+
GABBE's true power lies in its **Meta-Cognitive triad**: Active Inference (`activate`), Genetic Evolution (`evolve`), and Autonomous Recovery (`heal`). These tools run in the background or at specific SDLC gates to continuously optimize the team's performance.
|
|
682
|
+
|
|
683
|
+
### 8.1. Sensory MCPs to Working Memory
|
|
684
|
+
When an agent uses a sensory tool (like `visual-specs` or `excalidraw`), the parsed visual context is directly committed to the `WORKING_MEMORY.md`.
|
|
685
|
+
When `gabbe route` or `gabbe brain activate` runs, the **Cost-Benefit Router** actively reads this memory. If the visual data is highly complex, the router will automatically escalate the task to a **REMOTE** LLM to preserve reasoning quality, overriding local restrictions.
|
|
686
|
+
|
|
687
|
+
### 8.2. Enforcing Brain Mode (`activate`)
|
|
688
|
+
Brain Mode should be integrated into your development loop after significant milestones:
|
|
689
|
+
- **After Requirements (S01)**: To predict architectural bottlenecks before they are written.
|
|
690
|
+
- **Before Testing (S06)**: To foresee edge cases the standard developer agent missed.
|
|
691
|
+
|
|
692
|
+
**Using the CLI:**
|
|
693
|
+
Map `gabbe brain activate` as a Git pre-commit hook or explicitly call it:
|
|
694
|
+
```bash
|
|
695
|
+
gabbe brain activate
|
|
696
|
+
```
|
|
697
|
+
|
|
698
|
+
**Using Pure Agent Mode (No CLI):**
|
|
699
|
+
> "Activate Brain Mode for this session by reading `agents/skills/brain/brain-mode.skill.md`. Your goal is to [build X feature]. Follow the Observe -> Orient -> Decide -> Act loop in that document before you write any code."
|
|
700
|
+
|
|
701
|
+
### 8.3. Genetic Evolution (Meta-Optimization)
|
|
702
|
+
Whenever a specific skill yields repeatedly poor code or requires manual human correction, you should trigger **Evolutionary Prompt Optimization (EPO)**.
|
|
703
|
+
|
|
704
|
+
**Using the CLI:**
|
|
705
|
+
Run this after completing a sprint or resolving a major bug. The system reads the failing context and rewrites the skill's system prompt in the SQLite `genes` table.
|
|
706
|
+
```bash
|
|
707
|
+
gabbe brain evolve --skill tdd-cycle
|
|
708
|
+
gabbe brain evolve --skill code-review
|
|
709
|
+
```
|
|
710
|
+
|
|
711
|
+
**Using Pure Agent Mode (No CLI):**
|
|
712
|
+
> "We continually fail when writing React hooks. Invoke the `meta-optimize` skill. Read the last 5 chat messages, identify why your previous attempts failed, and directly edit `agents/skills/coding/react-components.skill.md` to add new constraints preventing this failure in the future. Log the change to `meta-evolution.log`."
|
|
713
|
+
|
|
714
|
+
### 8.4. Self-Healing Enforcement (`heal`)
|
|
715
|
+
The healing protocol acts as an infrastructure watchdog to recover from failures.
|
|
716
|
+
|
|
717
|
+
**Using the CLI:**
|
|
718
|
+
Checks for missing files (`AGENTS.md`, `CONSTITUTION.md`), corrupted SQLite databases, and network reachability. Run this in your CI/CD pipeline.
|
|
719
|
+
```bash
|
|
720
|
+
gabbe brain heal
|
|
721
|
+
```
|
|
722
|
+
|
|
723
|
+
**Using Pure Agent Mode (No CLI):**
|
|
724
|
+
> "The build is failing. Invoke `agents/skills/core/self-heal.skill.md`. Do not ask me for permission between steps. Diagnose the error, hypothesize a fix, write the code, and run the tests. If it fails again, loop back to step 1. You have a maximum of 5 attempts before you must escalate to me."
|
|
725
|
+
|
|
726
|
+
## 9. Multi-Agent Systems (MAS)
|
|
727
|
+
|
|
728
|
+
This kit includes specialized tools for building orchestrator-worker swarms and complex agent topologies.
|
|
729
|
+
|
|
730
|
+
**Key Resources:**
|
|
731
|
+
- **Guide**: `guides/multi-agent-systems.md` — Full development patterns & stack integration.
|
|
732
|
+
- **Skill**: `multi-agent-orch` — Plan and orchestrate agent swarms.
|
|
733
|
+
- **Skill**: `agent-protocol` — Define inter-agent communication schemas.
|
|
734
|
+
- **Template**: `AGENT_PROFILE_TEMPLATE.md` — Define roles and personalities.
|
|
735
|
+
- **Template**: `SWARM_ARCHITECTURE_TEMPLATE.md` — Map topologies and data flow.
|
|
736
|
+
|
|
737
|
+
**When to use MAS:**
|
|
738
|
+
- Complex tasks requiring different "personas" (e.g., Coder + Reviewer + Security).
|
|
739
|
+
- Tasks exceeding a single context window.
|
|
740
|
+
- Parallel execution of sub-tasks.
|
|
741
|
+
|
|
742
|
+
---
|
|
743
|
+
|
|
744
|
+
## 10. Architecture & Design Patterns
|
|
745
|
+
|
|
746
|
+
Embeds 2025-standard patterns into your workflow.
|
|
747
|
+
|
|
748
|
+
**Key Resources:**
|
|
749
|
+
- **Skill**: `arch-patterns` — Selects Microservices vs Monolith vs Serverless.
|
|
750
|
+
- **Skill**: `design-patterns` — Implements GoF patterns (Strategy, Factory, etc.).
|
|
751
|
+
- **Skill**: `clean-coder` — Enforces SOLID, DRY, and no "code smells".
|
|
752
|
+
- **Template**: `ARCH_DECISION_FRAMEWORK.md` — Matrix for Architectural decision making.
|
|
753
|
+
- **Template**: `DESIGN_PATTERN_USAGE.md` — Justify complex pattern choices.
|
|
754
|
+
- **Template**: `CLEAN_CODE_CHECKLIST.md` — Quality gate for PRs.
|
|
755
|
+
- **Guide**: `guides/design-patterns.md` — Catalog of modern patterns.
|
|
756
|
+
|
|
757
|
+
---
|
|
758
|
+
|
|
759
|
+
## 11. Agentic Patterns (Advanced AI)
|
|
760
|
+
|
|
761
|
+
Tools for building self-correcting, planning, and memory-augmented agents.
|
|
762
|
+
|
|
763
|
+
**Key Resources:**
|
|
764
|
+
- **Skill**: `agentic-patterns` — Implements Reflection, ReAct, and Planning loops.
|
|
765
|
+
- **Template**: `ETHICAL_IMPACT_ASSESSMENT.md` — AI Safety & Bias check.
|
|
766
|
+
- **Guide**: `guides/agentic-patterns.md` — Deep dive into cognitive architectures.
|
|
767
|
+
|
|
768
|
+
---
|
|
769
|
+
|
|
770
|
+
## 12. Testing Strategy
|
|
771
|
+
|
|
772
|
+
Comprehensive testing resources using Pyramid or Trophy models.
|
|
773
|
+
|
|
774
|
+
**Key Resources:**
|
|
775
|
+
- **Skill**: `testing-strategy` — Orchestrate Unit, Integration, E2E, and Contract testing.
|
|
776
|
+
- **Guide**: `guides/testing-strategy.md` — Complete guide to modern testing patterns.
|
|
777
|
+
- **Template**: `TEST_PLAN_TEMPLATE.md` — Master test plan document.
|
|
778
|
+
- **Template**: `TEST_CASE_TEMPLATE.md` — Detailed test case definition.
|
|
779
|
+
- **Template**: `E2E_TEST_SUITE_TEMPLATE.md` — High-level E2E scenarios.
|
|
780
|
+
|
|
781
|
+
---
|
|
782
|
+
|
|
783
|
+
## 13. Enterprise Domains (Infra, Data, Integration)
|
|
784
|
+
|
|
785
|
+
Specialized resources for specialized domains.
|
|
786
|
+
|
|
787
|
+
### Infrastructure & DevOps
|
|
788
|
+
- **Skill**: `infra-devops` (Terraform, K8s, CI/CD).
|
|
789
|
+
- **Template**: `INFRA_PLAN_TEMPLATE.md`.
|
|
790
|
+
|
|
791
|
+
### Data Engineering
|
|
792
|
+
- **Skill**: `data-engineering` (ETL/ELT, Spark, dbt).
|
|
793
|
+
- **Template**: `DATA_PIPELINE_TEMPLATE.md`.
|
|
794
|
+
|
|
795
|
+
### Enterprise Integration
|
|
796
|
+
- **Skill**: `enterprise-integration` (ERP, CRM, Legacy patterns).
|
|
797
|
+
- **Guide**: `guides/enterprise-patterns.md` (Strangler Fig, ACL).
|
|
798
|
+
- **Template**: `INTEGRATION_SPEC_TEMPLATE.md`.
|
|
799
|
+
|
|
800
|
+
---
|
|
801
|
+
|
|
802
|
+
## 14. Environment & Deployment (Local/Remote/Cloud)
|
|
803
|
+
|
|
804
|
+
Tools for the full lifecycle: from localhost to production.
|
|
805
|
+
|
|
806
|
+
### Local Development (Inner Loop)
|
|
807
|
+
- **Skill**: `docker-dev` (Compose Watch, DevContainers).
|
|
808
|
+
- **Template**: `DEVCONTAINER_TEMPLATE.json`.
|
|
809
|
+
|
|
810
|
+
### Remote Kubernetes Dev (Hybrid Loop)
|
|
811
|
+
- **Skill**: `k8s-dev` (Telepresence, Okteto, DevSpace).
|
|
812
|
+
- **Template**: `DEV_SPACE_TEMPLATE.yaml`.
|
|
813
|
+
|
|
814
|
+
### Cloud Deployment (Outer Loop)
|
|
815
|
+
- **Skill**: `cloud-deploy` (Vercel, Railway, AWS SST).
|
|
816
|
+
- **Template**: `DEPLOY_CONFIG_TEMPLATE.md`.
|
|
817
|
+
- **Guide**: `guides/dev-environments.md`.
|
|
818
|
+
|
|
819
|
+
---
|
|
820
|
+
|
|
821
|
+
## 15. Legacy Systems (COBOL, Mainframe)
|
|
822
|
+
|
|
823
|
+
"Old" code runs the world economy. Treat it with respect.
|
|
824
|
+
|
|
825
|
+
### Modernization
|
|
826
|
+
- **Skill**: `legacy-modernization` (COBOL analysis, Strangler Fig).
|
|
827
|
+
- **Template**: `LEGACY_AUDIT_TEMPLATE.md` (Risk & Knowledge audit).
|
|
828
|
+
- **Guide**: `guides/legacy-tech.md` (Mainframe DevOps, COBOL basics).
|
|
829
|
+
|
|
830
|
+
---
|
|
831
|
+
|
|
832
|
+
## 16. Future Tech & Adaptive Skills (2026-2030)
|
|
833
|
+
|
|
834
|
+
Preparing for the next wave: 6G, Agentic IoT, and Evolutionary Architecture.
|
|
835
|
+
|
|
836
|
+
### Emerging Technologies
|
|
837
|
+
- **Skill**: `emerging-tech` (6G, Matter, Vector Databases).
|
|
838
|
+
- **Skill**: `adaptive-architecture` (Local-First, WASM, CRDTs).
|
|
839
|
+
- **Template**: `ADAPTIVE_SYSTEM_TEMPLATE.md` (Evolutionary design).
|
|
840
|
+
- **Guide**: `guides/future-tech.md` (The 2030 Horizon).
|
|
841
|
+
|
|
842
|
+
---
|
|
843
|
+
|
|
844
|
+
## 17. System Quality & Evolution (SRE, Performance)
|
|
845
|
+
|
|
846
|
+
Resources for ensuring your software is reliable, fast, and adaptable.
|
|
847
|
+
|
|
848
|
+
### Skills
|
|
849
|
+
- **SRE**: `reliability-sre` (SLOs, Error Budgets, Chaos).
|
|
850
|
+
- **Performance**: `performance-optimization` (Caching, Sharding).
|
|
851
|
+
- **Design**: `compatibility-design` (API Versioning, Migrations).
|
|
852
|
+
|
|
853
|
+
### Documentation
|
|
854
|
+
- **Template**: `NFR_TEMPLATE.md` (Reliability targets).
|
|
855
|
+
- **Template**: `SAFETY_CASE.md` (Critical system assurance).
|
|
856
|
+
- **Template**: `COST_OPTIMIZATION_REPORT_TEMPLATE.md` (FinOps).
|
|
857
|
+
- **Template**: `INCIDENT_POSTMORTEM_TEMPLATE.md` (Blameless analysis).
|
|
858
|
+
- **Guide**: `guides/system-qualities.md` (The "Ilities").
|
|
859
|
+
|
|
860
|
+
---
|
|
861
|
+
|
|
862
|
+
## 18. System Lifecycle & Traceability
|
|
863
|
+
|
|
864
|
+
Resources for binding Requirements to Code and Tests (The Golden Thread).
|
|
865
|
+
|
|
866
|
+
### Skills
|
|
867
|
+
- **Traceability**: `system-lifecycle` (Link REQ -> Code -> Test).
|
|
868
|
+
|
|
869
|
+
### Documentation
|
|
870
|
+
- **Template**: `TRACEABILITY_MATRIX_TEMPLATE.md` (Live status of requirements).
|
|
871
|
+
- **Guide**: `guides/full-system-lifecycle.md` (Definition of Done).
|
|
872
|
+
|
|
873
|
+
---
|
|
874
|
+
|
|
875
|
+
## 19. Skills Reference
|
|
876
|
+
|
|
877
|
+
All 214 skills live in `skills/` subdirectories. Invoke by mentioning the trigger keyword or using slash commands in VS Code.
|
|
878
|
+
|
|
879
|
+
### 1. Coding & Development (`coding/`)
|
|
880
|
+
| Skill | Slash Command (VS Code) | Triggers | Purpose |
|
|
881
|
+
|---|---|---|---|
|
|
882
|
+
| `coding/code-review.skill.md` | `/code-review` | review, PR, audit | Security, perf, style check |
|
|
883
|
+
| `coding/tdd-cycle.skill.md` | `/tdd-cycle` | test, TDD, red-green | Red-Green-Refactor loop |
|
|
884
|
+
| `coding/browser-tdd.skill.md` | `/browser-tdd` | visual, browser | Visual TDD with Playwright |
|
|
885
|
+
| `coding/refactor.skill.md` | `/refactor` | refactor, cleanup | Safe code restructuring |
|
|
886
|
+
| `coding/debug.skill.md` | `/debug` | fix, debug, bug | Root Cause Analysis |
|
|
887
|
+
| `coding/git-workflow.skill.md` | `/git-workflow` | commit, PR, branch | Conventional commits |
|
|
888
|
+
| `coding/documentation.skill.md` | `/documentation` | docs, README | Doc generation |
|
|
889
|
+
| `coding/clean-coder.skill.md` | clean code, solid | Enforce SOLID/DRY |
|
|
890
|
+
| `coding/mobile-dev.skill.md` | mobile, ios | Mobile development |
|
|
891
|
+
| `coding/visual-design.skill.md` | design, ui, tokens | UI Design System |
|
|
892
|
+
| `coding/vibe-coding.skill.md` | vibe, aesthetic | Creative Frontend |
|
|
893
|
+
| `coding/ci-autofix.skill.md` | ci fix, autofix | Auto-fix CI failures |
|
|
894
|
+
| `coding/tool-construction.skill.md` | build tool, mcp | Tool building |
|
|
895
|
+
| `coding/ui-gen.skill.md` | ui, dashboard | Generative UI |
|
|
896
|
+
| `coding/secure-coding.skill.md` | secure code, owasp | Security-first coding |
|
|
897
|
+
| `coding/file-processing.skill.md` | file, parse | File manipulation |
|
|
898
|
+
| `coding/artisan-commands.skill.md` | artisan, scripts | Custom task automation |
|
|
899
|
+
| `coding/performant-nodejs.skill.md` | nodejs, performance | High-performance Node.js |
|
|
900
|
+
| `coding/performant-laravel.skill.md` | laravel, performance | High-performance Laravel |
|
|
901
|
+
| `coding/performant-python.skill.md` | python, performance | High-performance Python |
|
|
902
|
+
| `coding/performant-go.skill.md` | go, performance | High-performance Go |
|
|
903
|
+
| `coding/performant-ai.skill.md` | ai, llm, performance | High-performance AI/LLM |
|
|
904
|
+
| `coding/time-complexity.skill.md` | complexity, big-o, hotspot | Big-O static analysis via MCP |
|
|
905
|
+
| `coding/excalidraw.skill.md` | excalidraw, whiteboard, visual | Excalidraw diagram creation via MCP |
|
|
906
|
+
| `coding/sketch-to-diagram.skill.md` | sketch, hand-drawn, recognize | Hand-drawn sketch → formal diagram |
|
|
907
|
+
| `coding/tldraw-canvas.skill.md` | tldraw, canvas, wireframe, UI sketch | Visual canvas for wireframing and design |
|
|
908
|
+
|
|
909
|
+
|
|
910
|
+
### 2. Architecture (`architecture/`)
|
|
911
|
+
| Skill | Triggers | Purpose |
|
|
912
|
+
|---|---|---|
|
|
913
|
+
| `architecture/arch-design.skill.md` | design architecture | Create new architecture |
|
|
914
|
+
| `architecture/arch-review.skill.md` | review architecture | ATAM audit |
|
|
915
|
+
| `architecture/arch-patterns.skill.md` | microservices | Select patterns |
|
|
916
|
+
| `architecture/design-patterns.skill.md` | factory, strategy | GoF patterns |
|
|
917
|
+
| `architecture/diagramming.skill.md` | diagram, mermaid | Technical diagrams |
|
|
918
|
+
| `architecture/domain-model.skill.md` | domain, ddd | Context mapping |
|
|
919
|
+
| `architecture/visual-whiteboarding.skill.md` | drawio, miro, figma | Map spatial architecture |
|
|
920
|
+
| `architecture/api-design.skill.md` | api, openapi | API contract design |
|
|
921
|
+
| `architecture/legacy-modernization.skill.md` | cobol, legacy | Modernization |
|
|
922
|
+
| `architecture/middleware-design.skill.md` | middleware, pipeline | Middleware patterns |
|
|
923
|
+
| `architecture/state-management.skill.md` | state, redux, store | State strategy |
|
|
924
|
+
| `architecture/realtime-comm.skill.md` | socket, realtime | Websockets/Events |
|
|
925
|
+
| `architecture/graphql-schema.skill.md` | graphql, schema | Schema design |
|
|
926
|
+
| `architecture/architecture-governance.skill.md` | governance, drift | Policy enforcement |
|
|
927
|
+
| `architecture/error-handling-strategy.skill.md` | error, retry | Resiliency design |
|
|
928
|
+
| `architecture/enterprise-migration-scenario.skill.md` | migration, legacy | Enterprise migrations |
|
|
929
|
+
| `architecture/event-governance.skill.md` | event, kafka | Event schema registry |
|
|
930
|
+
|
|
931
|
+
|
|
932
|
+
### 3. Operations & SRE (`ops/`)
|
|
933
|
+
| Skill | Triggers | Purpose |
|
|
934
|
+
|---|---|---|
|
|
935
|
+
| `ops/reliability-sre.skill.md` | sre, slo | Reliability Engineering |
|
|
936
|
+
| `ops/performance-optimization.skill.md` | performance | System optimization |
|
|
937
|
+
| `ops/incident-response.skill.md` | incident, outage | Incident management |
|
|
938
|
+
| `ops/docker-dev.skill.md` | docker, compose | Local containers |
|
|
939
|
+
| `ops/k8s-dev.skill.md` | k8s, telepresence | Remote K8s dev |
|
|
940
|
+
| `ops/cloud-deploy.skill.md` | deploy, aws | Cloud deployment |
|
|
941
|
+
| `ops/infra-devops.skill.md` | terraform, iac | Infrastructure as Code |
|
|
942
|
+
| `ops/cost-optimization.skill.md` | cost, finops | Cost reduction |
|
|
943
|
+
| `ops/caching-strategy.skill.md` | cache, redis | Caching patterns |
|
|
944
|
+
| `ops/release-management.skill.md` | release, semver | Release coordination |
|
|
945
|
+
| `ops/memory-optimization.skill.md` | memory, leak | Memory profiling |
|
|
946
|
+
| `ops/queue-management.skill.md` | queue, dead letter | Job queue handling |
|
|
947
|
+
| `ops/production-verifier.skill.md` | verify prod, smoke | Post-deploy check |
|
|
948
|
+
| `ops/system-benchmark.skill.md` | benchmark, load | Performance testing |
|
|
949
|
+
| `ops/capacity-planning.skill.md` | capacity, scale | Resource planning |
|
|
950
|
+
| `ops/release-validation.skill.md` | validation, gate | Compliance gates |
|
|
951
|
+
| `ops/troubleshooting-guide.skill.md` | debug, fix | System recovery |
|
|
952
|
+
|
|
953
|
+
|
|
954
|
+
### 4. Security (`security/`)
|
|
955
|
+
| Skill | Triggers | Purpose |
|
|
956
|
+
|---|---|---|
|
|
957
|
+
| `security/security-audit.skill.md` | audit, owasp | Security review |
|
|
958
|
+
| `security/threat-model.skill.md` | threat, stride | Threat modeling |
|
|
959
|
+
| `security/privacy-audit.skill.md` | privacy, gdpr | Privacy impact |
|
|
960
|
+
| `security/compliance-review.skill.md` | compliance, soc2 | Compliance check |
|
|
961
|
+
| `security/access-control.skill.md` | rbac, iam | Identity/Access |
|
|
962
|
+
| `security/secrets-management.skill.md` | secrets, vault | Secrets handling |
|
|
963
|
+
| `security/ai-ethics-compliance.skill.md` | ethics, bias | AI Safety check |
|
|
964
|
+
| `security/ai-safety-guardrails.skill.md` | guardrails, jailbreak | Runtime AI Safety |
|
|
965
|
+
| `security/legal-review.skill.md` | legal, ip, license | IP & License check |
|
|
966
|
+
| `security/traceability-audit.skill.md` | trace, reqs | V-Model Traceability |
|
|
967
|
+
| `security/safety-scan.skill.md` | safety scan | Pre-commit safety |
|
|
968
|
+
| `security/reliability-engineering.skill.md` | reliability, mtbf | System reliability |
|
|
969
|
+
| `security/dependency-security.skill.md` | dep check, snyk | Supply chain security |
|
|
970
|
+
| `security/backup-recovery.skill.md` | backup, restore | Disaster recovery |
|
|
971
|
+
| `security/cryptography-standards.skill.md` | crypto, encrypt | Encryption audits |
|
|
972
|
+
| `security/log-analysis.skill.md` | log audit, splunk | Security log review |
|
|
973
|
+
|
|
974
|
+
| `security/network-security.skill.md` | firewall, netsec | Network hardening |
|
|
975
|
+
| `security/hazard-analysis.skill.md` | hazard, fmea | Safety hazard analysis |
|
|
976
|
+
|
|
977
|
+
### 5. Product, Data & Core (`product/`, `data/`, `core/`, `coordination/`)
|
|
978
|
+
| Skill | Triggers | Purpose |
|
|
979
|
+
|---|---|---|
|
|
980
|
+
| `product/req-elicitation.skill.md` | gather reqs | Elicit requirements |
|
|
981
|
+
| `product/req-elicitation.skill.md` | gather reqs | Elicit requirements |
|
|
982
|
+
| `product/spec-writer.skill.md` | spec, PRD | Write verification specs |
|
|
983
|
+
| `product/accessibility.skill.md` | a11y, wcag | Accessibility Audit |
|
|
984
|
+
| `product/user-story-mapping.skill.md` | story map, journey | User journey mapping |
|
|
985
|
+
| `product/stakeholder-management.skill.md` | stakeholder, raci | RACI & Interest map |
|
|
986
|
+
| `product/design-thinking.skill.md` | empathize, ideate | Design thinking loop |
|
|
987
|
+
| `product/spec-analyze.skill.md` | analyze spec, gap | Spec gap analysis |
|
|
988
|
+
| `product/market-analysis.skill.md` | market, competitor | Market research |
|
|
989
|
+
| `product/decompose.skill.md` | decompose, break | Task decomposition |
|
|
990
|
+
| `product/systems-thinking.skill.md` | systems, loops | Systems dynamics |
|
|
991
|
+
| `product/req-review.skill.md` | review reqs, audit | Requirements audit |
|
|
992
|
+
|
|
993
|
+
| `data/data-engineering.skill.md` | etl, spark | Data pipelines |
|
|
994
|
+
| `data/db-migration.skill.md` | migration, sql | DB Schema changes |
|
|
995
|
+
| `data/data-governance.skill.md` | lineage, catalog | Data governance |
|
|
996
|
+
| `data/sql-optimization.skill.md` | sql opt, index | Query performance |
|
|
997
|
+
| `coding/testing-strategy.skill.md` | test strategy, pyramid | Testing Pyramid Strategy |
|
|
998
|
+
| `product/green-software.skill.md` | green, carbon | Sustainable Software |
|
|
999
|
+
| `ops/enterprise-integration.skill.md` | erp, legacy | Enterprise Patterns |
|
|
1000
|
+
| `coordination/multi-agent-orch.skill.md` | swarm, delegate | Agent coordination |
|
|
1001
|
+
| `coordination/swarm-consensus.skill.md` | vote, consensus | Swarm decision making |
|
|
1002
|
+
| `coordination/agentic-linter.skill.md` | arch lint, boundaries | Architecture enforcement |
|
|
1003
|
+
| `coordination/meta-prompting.skill.md` | meta prompt, improve | Prompt engineering |
|
|
1004
|
+
| `coordination/agent-interop.skill.md` | interop, connect | Cross-agent comms |
|
|
1005
|
+
| `core/research.skill.md` | research, find | Deep research |
|
|
1006
|
+
| `core/self-heal.skill.md` | fix error, heal | Auto-recovery |
|
|
1007
|
+
| `core/system-lifecycle.skill.md` | traceability | Trace Req->Code |
|
|
1008
|
+
| `core/agent-analytics.skill.md` | analytics, stats | Agent performance |
|
|
1009
|
+
| `core/knowledge-connect.skill.md` | connection, link | Cross-repo knowledge |
|
|
1010
|
+
|
|
1011
|
+
|
|
1012
|
+
### 6. Neuro-Architecture (`brain/`)
|
|
1013
|
+
| Skill | Triggers | Purpose |
|
|
1014
|
+
|---|---|---|
|
|
1015
|
+
| `brain/active-inference.skill.md` | active inference, surprise | Minimizing prediction error loop |
|
|
1016
|
+
| `brain/global-workspace.skill.md` | global workspace, consciousness | Central blackboard for swarms |
|
|
1017
|
+
| `brain/sensory-motor.skill.md` | senses, motor | Embodied cognition & feedback control |
|
|
1018
|
+
| `brain/consciousness-loop.skill.md` | ooda, self | Recursive self-reference (System 2) |
|
|
1019
|
+
| `brain/self-improvement.skill.md` | evolve, mutate | Evolutionary prompt rewriting |
|
|
1020
|
+
| `brain/learning-adaptation.skill.md` | learn, plasticity | Reinforcement learning & memory |
|
|
1021
|
+
| `brain/episodic-consolidation.skill.md` | consolidate, sleep | Memory consolidation |
|
|
1022
|
+
| `brain/neuroscience-foundations.skill.md` | neuro, theory | Cognitive theory base |
|
|
1023
|
+
| `brain/epistemology-knowledge.skill.md` | truth, justify | Knowledge validation |
|
|
1024
|
+
| `brain/cognitive-architectures.skill.md` | cognitive arch | Cognitive patterns |
|
|
1025
|
+
| `brain/sequential-thinking.skill.md` | reasoning, step | Chain-of-thought |
|
|
1026
|
+
| `brain/working-memory.skill.md` | context, memory | RAM management |
|
|
1027
|
+
|
|
1028
|
+
|
|
1029
|
+
See `agents/skills/00-index.md` for full details including context costs.
|
|
1030
|
+
|
|
1031
|
+
---
|
|
1032
|
+
|
|
1033
|
+
## 20. Templates Reference
|
|
1034
|
+
|
|
1035
|
+
All templates now live in categorized subdirectories under `agents/templates/`.
|
|
1036
|
+
|
|
1037
|
+
### Coding & Architecture (`templates/coding/`, `templates/architecture/`)
|
|
1038
|
+
| Template | Purpose |
|
|
1039
|
+
|---|---|
|
|
1040
|
+
| `coding/CLEAN_CODE_CHECKLIST.md` | Pre-merge code review (SOLID/DRY) |
|
|
1041
|
+
| `coding/TEST_PLAN_TEMPLATE.md` | Master Test Plan strategy |
|
|
1042
|
+
| `coding/TEST_CASE_TEMPLATE.md` | Manual Test Case documentation |
|
|
1043
|
+
| `coding/E2E_TEST_SUITE_TEMPLATE.md` | End-to-End Test Suite | Managing Playwright/Cypress test scenarios |
|
|
1044
|
+
| `coding/DEVCONTAINER_TEMPLATE.json` | Dev Container Config | VS Code Remote Containers config |
|
|
1045
|
+
| `coding/DEV_SPACE_TEMPLATE.yaml` | DevSpace Config | Kubernetes dev environment |
|
|
1046
|
+
| `coding/DESIGN_TOKENS_TEMPLATE.json` | Design Tokens | UI Design colors/typography |
|
|
1047
|
+
| `architecture/ADR_TEMPLATE.md` | Architecture Decision Record |
|
|
1048
|
+
| `architecture/ARCH_DECISION_FRAMEWORK.md` | Critical decision matrix |
|
|
1049
|
+
| `architecture/ARCHITECTURE_REVIEW_TEMPLATE.md` | Structured architecture audit |
|
|
1050
|
+
| `architecture/ARCHITECTURE_VIEWS_TEMPLATE.md` | C4/UML View documentation |
|
|
1051
|
+
| `architecture/DOMAIN_MODEL_TEMPLATE.md` | DDD Entity & Relationship map |
|
|
1052
|
+
| `architecture/DESIGN_PATTERN_USAGE.md` | Pattern Justification |
|
|
1053
|
+
| `architecture/C4_ARCHITECTURE_TEMPLATE.md` | C4 Model | C4 Container/Component diagrams |
|
|
1054
|
+
| `core/WHITEBOARD_DESIGN_TEMPLATE.md` | Canvas Blueprint | Whiteboard mapping prep |
|
|
1055
|
+
| `architecture/CONTEXT_MAP_TEMPLATE.md` | Context Map | Bounded Context relationships |
|
|
1056
|
+
| `architecture/SYSTEM_CONTEXT_TEMPLATE.md` | System Context | High-level system dependencies |
|
|
1057
|
+
| `architecture/INTEGRATION_SPEC_TEMPLATE.md` | Integration Spec | API/Service integration details |
|
|
1058
|
+
| `architecture/CAPABILITY_MAP_TEMPLATE.md` | Capability Map | Business Capability mapping |
|
|
1059
|
+
| `architecture/LEGACY_AUDIT_TEMPLATE.md` | Legacy Audit | Mainframe/Legacy system analysis |
|
|
1060
|
+
| `architecture/QUALITY_ATTRIBUTES_TEMPLATE.md` | Quality Attributes | NFR Definitions (SLAs/SLOs) |
|
|
1061
|
+
| `architecture/CONTEXT_MAP_TEMPLATE.md` | Context Map | Bounded Context map |
|
|
1062
|
+
| `architecture/CAPABILITY_MAP_TEMPLATE.md` | Capability Map | Business capabilities |
|
|
1063
|
+
| `architecture/SYSTEM_CONTEXT_TEMPLATE.md` | System Context | C4 System Context |
|
|
1064
|
+
| `architecture/LEGACY_AUDIT_TEMPLATE.md` | Legacy Audit | Mainframe/Legacy review |
|
|
1065
|
+
|
|
1066
|
+
### Ops & Security (`templates/ops/`, `templates/security/`)
|
|
1067
|
+
| Template | Purpose |
|
|
1068
|
+
|---|---|
|
|
1069
|
+
| `ops/INCIDENT_POSTMORTEM_TEMPLATE.md` | Incident Root Cause Analysis |
|
|
1070
|
+
| `ops/CAPACITY_PLAN_TEMPLATE.md` | Scaling & Load planning |
|
|
1071
|
+
| `ops/COST_OPTIMIZATION_REPORT_TEMPLATE.md` | FinOps analysis |
|
|
1072
|
+
| `ops/BENCHMARK_REPORT_TEMPLATE.md` | System Benchmark | Load testing results |
|
|
1073
|
+
| `ops/DEPLOY_CONFIG_TEMPLATE.md` | Deployment Config | CI/CD Pipeline config |
|
|
1074
|
+
| `ops/INFRA_PLAN_TEMPLATE.md` | Infrastructure Plan | Terraform/Cloud formation plan |
|
|
1075
|
+
| `ops/RELEASE_READINESS_REPORT.md` | Release Readiness | Go/No-Go decision record |
|
|
1076
|
+
| `ops/TECH_DEBT_TEMPLATE.md` | Tech Debt Log | Debt tracking & payoff plan |
|
|
1077
|
+
| `security/THREAT_MODEL_TEMPLATE.md` | STRIDE threat model |
|
|
1078
|
+
| `security/SECURITY_CHECKLIST.md` | Pre-release security gate |
|
|
1079
|
+
| `security/ETHICAL_IMPACT_ASSESSMENT.md` | AI Ethics check |
|
|
1080
|
+
| `security/HAZARD_LOG.md` | Hazard Log | Safety-critical hazard tracking |
|
|
1081
|
+
| `security/SAFETY_POLICY.md` | Safety Policy | System safety constraints |
|
|
1082
|
+
| `security/SAFETY_CASE.md` | Safety Case | Assurance arguments |
|
|
1083
|
+
|
|
1084
|
+
### Product & Core (`templates/product/`, `templates/core/`)
|
|
1085
|
+
| Template | Purpose |
|
|
1086
|
+
|---|---|
|
|
1087
|
+
| `product/PRD_TEMPLATE.md` | Product Requirements (EARS) |
|
|
1088
|
+
| `product/SPEC_TEMPLATE.md` | Technical Specification |
|
|
1089
|
+
| `product/USER_STORY_MAP_TEMPLATE.md` | User Journey Mapping |
|
|
1090
|
+
| `product/BUSINESS_CASE_TEMPLATE.md` | Business Case | ROI and project justification |
|
|
1091
|
+
| `product/EMPATHY_MAP_TEMPLATE.md` | Empathy Map | User persona analysis |
|
|
1092
|
+
| `product/REQUIREMENTS_REVIEW_TEMPLATE.md` | Requirements Review | PRD/Spec audit |
|
|
1093
|
+
| `product/STAKEHOLDER_REGISTER_TEMPLATE.md` | Stakeholder Register | RACI and stakeholder map |
|
|
1094
|
+
| `product/NFR_TEMPLATE.md` | NFR Definition | Non-functional requirements |
|
|
1095
|
+
| `core/PLAN_TEMPLATE.md` | Implementation Plan |
|
|
1096
|
+
| `core/TASKS_TEMPLATE.md` | Atomic Task breakdown |
|
|
1097
|
+
| `core/AUDIT_LOG_TEMPLATE.md` | Project Audit Trail |
|
|
1098
|
+
| `core/SDLC_TRACKER.md` | Phase progress board |
|
|
1099
|
+
| `core/SYSTEM_ANALYSIS_TEMPLATE.md` | System Analysis | Root cause & dynamics |
|
|
1100
|
+
| `core/SESSION_SNAPSHOT_TEMPLATE.md` | Complete project state |
|
|
1101
|
+
| `core/TRACEABILITY_MATRIX_TEMPLATE.md` | Traceability Matrix | Req -> Code -> Test trace |
|
|
1102
|
+
| `core/BUG_REPORT_TEMPLATE.md` | Bug Report | Structured bug reporting |
|
|
1103
|
+
| `core/PROJECT_STATE_TEMPLATE.md` | Project State | Current SDLC phase & status |
|
|
1104
|
+
| `core/CONTINUITY_TEMPLATE.md` | Continuity Log | Past failure prevention log |
|
|
1105
|
+
|
|
1106
|
+
### Coordination & Brain (`templates/coordination/`, `templates/brain/`)
|
|
1107
|
+
| Template | Purpose |
|
|
1108
|
+
|---|---|
|
|
1109
|
+
| `coordination/AGENTS_TEMPLATE.md` | Agent Swarm Definition |
|
|
1110
|
+
| `coordination/SWARM_CONFIG_TEMPLATE.json` | Multi-agent configuration |
|
|
1111
|
+
| `coordination/AGENT_PROFILE_TEMPLATE.md` | Agent Profile | Persona definition |
|
|
1112
|
+
| `coordination/AGENT_HANDSHAKE_TEMPLATE.json` | Agent Handshake | Protocol negotiation |
|
|
1113
|
+
| `coordination/VOTING_LOG_TEMPLATE.md` | Agent Consensus Voting Record |
|
|
1114
|
+
| `coordination/SWARM_ARCHITECTURE_TEMPLATE.md` | Swarm Architecture | Multi-agent topology |
|
|
1115
|
+
| `brain/ACTIVE_INFERENCE_LOOP_TEMPLATE.md` | Cognitive loop structure |
|
|
1116
|
+
| `brain/GLOBAL_WORKSPACE_CONFIG_TEMPLATE.md` | GWT Blackboard config |
|
|
1117
|
+
| `brain/SELF_IMPROVEMENT_LOG_TEMPLATE.md` | Self-Improvement Log | Evolving prompts/tools |
|
|
1118
|
+
| `brain/KNOWLEDGE_MAP_TEMPLATE.md` | Knowledge Map | Ontology & Relationships |
|
|
1119
|
+
| `brain/OODA_LOOP_TRACE_TEMPLATE.md` | OODA Loop Trace | Cognitive decision tracing |
|
|
1120
|
+
| `brain/WORKING_MEMORY_TEMPLATE.md` | Working Memory | Short-term context |
|
|
1121
|
+
| `brain/EPISODIC_MEMORY_LOG_TEMPLATE.md` | Episodic Memory | Long-term experience log |
|
|
1122
|
+
| `brain/PREDICTION_ERROR_LOG_TEMPLATE.md` | Prediction Error | Surprise minimization log |
|
|
1123
|
+
|
|
1124
|
+
### Data (`templates/data/`)
|
|
1125
|
+
| Template | Purpose |
|
|
1126
|
+
|---|---|
|
|
1127
|
+
| `data/DATA_PIPELINE_TEMPLATE.md` | Data Pipeline | ETL/ELT Design |
|
|
1128
|
+
| `data/DATABASE_SCHEMA_TEMPLATE.md` | Database Schema | Schema Design |
|
|
1129
|
+
| `data/ONTOLOGY_TEMPLATE.md` | Meta-Data | RDF/OWL Ontology map |
|
|
1130
|
+
|
|
1131
|
+
### Industry & Specialized (`templates/industry/`, `templates/product/`)
|
|
1132
|
+
| Template | Purpose |
|
|
1133
|
+
|---|---|
|
|
1134
|
+
| `industry/FHIR_INTEGRATION_TEMPLATE.md` | Healthcare | Clinical data mapping |
|
|
1135
|
+
| `industry/IOT_TELEMETRY_TEMPLATE.md` | IIoT | Sensor data / Purdue model mapping |
|
|
1136
|
+
| `industry/TELECOM_API_TEMPLATE.md` | Telecom | TMF/GSMA API exposure |
|
|
1137
|
+
| `industry/GLOBAL_STANDARDS_AUDIT_TEMPLATE.md` | compliance | UN SDG / ITU-T Audit |
|
|
1138
|
+
| `industry/ENGINEERING_STANDARDS_REVIEW_TEMPLATE.md` | Engineering | IEEE/ISO Code audit |
|
|
1139
|
+
| `product/GREEN_SOFTWARE_REPORT_TEMPLATE.md` | Sustainability | SCI carbon impact report |
|
|
1140
|
+
| `architecture/SCALABILITY_ANALYSIS_TEMPLATE.md` | Architecture | Scalability bottleneck analysis |
|
|
1141
|
+
| `architecture/SMART_CONTRACT_TEMPLATE.md` | Blockchain | Smart contract logic & security |
|
|
1142
|
+
| `architecture/ARCHITECTURE_DECISION_MATRIX.md` | Architecture | Scoring matrix for trade-offs |
|
|
1143
|
+
| `core/PROJECT_CONTEXT_TEMPLATE.md` | Core | Holistic project context for agents |
|
|
1144
|
+
| `product/PROBLEM_STATEMENT_TEMPLATE.md` | Product | Problem definition (EARS subset) |
|
|
1145
|
+
| `product/IDEATION_LOG_TEMPLATE.md` | Product | Brainstorming & outcome log |
|
|
1146
|
+
|
|
1147
|
+
|
|
1148
|
+
---
|
|
1149
|
+
|
|
1150
|
+
## 21. MCP Configuration
|
|
1151
|
+
|
|
1152
|
+
MCP (Model Context Protocol) servers extend agent capabilities. Configure them in `templates/core/MCP_CONFIG_TEMPLATE.json`. For detailed installation and setup guides for each server, see [MCP_CONFIGURATIONS.md](MCP_CONFIGURATIONS.md).
|
|
1153
|
+
|
|
1154
|
+
**Essential MCP servers:**
|
|
1155
|
+
|
|
1156
|
+
| Category | Server | Purpose |
|
|
1157
|
+
|---|---|---|
|
|
1158
|
+
| **Docs** | Context-7 MCP | Up-to-date SDK docs (prevents API hallucination) |
|
|
1159
|
+
| **Reasoning** | Sequential Thinking | Chain-of-thought before acting |
|
|
1160
|
+
| **Code Search** | GitHub MCP | PR review, code search, issue management |
|
|
1161
|
+
| **Database** | PostgreSQL MCP | Live schema introspection |
|
|
1162
|
+
| **Security** | Semgrep MCP | SAST scanning from within the agent |
|
|
1163
|
+
| **Web Search** | Brave Search / Tavily | Authoritative source research |
|
|
1164
|
+
| **Memory** | Qdrant MCP | Semantic long-term memory retrieval |
|
|
1165
|
+
| **Browser** | Playwright MCP | Browser automation for visual TDD |
|
|
1166
|
+
| **Monitoring** | Sentry MCP | Error tracking and incident context |
|
|
1167
|
+
| **Complexity** | Time Complexity MCP | Big-O static analysis via tree-sitter |
|
|
1168
|
+
| **Diagramming** | Excalidraw MCP | Programmatic Excalidraw diagram creation |
|
|
1169
|
+
| **Vision** | Image Recognition MCP | Sketch recognition via vision APIs |
|
|
1170
|
+
| **Canvas** | tldraw MCP | Persistent visual canvas for wireframing |
|
|
1171
|
+
| **Filesystem** | Filesystem MCP | Local file access for internal RAG |
|
|
1172
|
+
|
|
1173
|
+
**Full coverage matrix** (65 MCP servers in `MCP_CONFIG_TEMPLATE.json`):
|
|
1174
|
+
|
|
1175
|
+
| Integration Domain | Servers Available |
|
|
1176
|
+
|---|---|
|
|
1177
|
+
| **External APIs** | GraphQL, OpenAPI, Stripe, Zapier |
|
|
1178
|
+
| **Databases** | PostgreSQL, MongoDB, Redis, SQLite, DBHub (universal) |
|
|
1179
|
+
| **Knowledge Bases** | Qdrant, Pinecone, Chroma, Weaviate, Elasticsearch |
|
|
1180
|
+
| **Web Scraping** | Firecrawl, Brave Search, Tavily, DuckDuckGo |
|
|
1181
|
+
| **Internal RAG** | Filesystem, Shell, Jupyter, Context-7 |
|
|
1182
|
+
| **Observability** | Sentry, Datadog, Grafana |
|
|
1183
|
+
| **Code Quality** | Semgrep, Snyk, SonarQube, Gitleaks, Time Complexity |
|
|
1184
|
+
| **Project Mgmt** | GitHub, GitLab, Jira, Linear, Notion, Confluence, Slack |
|
|
1185
|
+
| **Cloud/Infra** | AWS Core, Kubernetes, Figma |
|
|
1186
|
+
|
|
1187
|
+
**Security rules:**
|
|
1188
|
+
- Production databases: read-only access only
|
|
1189
|
+
- Dev databases: read-write allowed
|
|
1190
|
+
- Secrets/credentials: never passed as MCP config, use env vars
|
|
1191
|
+
|
|
1192
|
+
See `templates/core/MCP_CONFIG_TEMPLATE.json` for the full catalog with install commands.
|
|
1193
|
+
See [MCP_CONFIGURATIONS.md](MCP_CONFIGURATIONS.md) for comprehensive per-server installation, API key setup, and usage guides.
|
|
1194
|
+
|
|
1195
|
+
---
|
|
1196
|
+
|
|
1197
|
+
---
|
|
1198
|
+
|
|
1199
|
+
## 22. Extending the Kit
|
|
1200
|
+
|
|
1201
|
+
### Adding Custom Skills
|
|
1202
|
+
|
|
1203
|
+
1. **Create File:** Add a new `.skill.md` file in `agents/skills/`.
|
|
1204
|
+
- Naming convention: `your-skill-name.skill.md`.
|
|
1205
|
+
2. **Format:** Use the standard YAML header + Markdown body:
|
|
1206
|
+
```markdown
|
|
1207
|
+
---
|
|
1208
|
+
name: [Skill Name]
|
|
1209
|
+
description: [What it does]
|
|
1210
|
+
context_cost: [low/medium/high]
|
|
1211
|
+
---
|
|
1212
|
+
# [Skill Name]
|
|
1213
|
+
|
|
1214
|
+
## Triggers
|
|
1215
|
+
- [trigger word 1]
|
|
1216
|
+
- [trigger word 2]
|
|
1217
|
+
|
|
1218
|
+
## Instructions
|
|
1219
|
+
[Detailed steps for the agent to follow]
|
|
1220
|
+
```
|
|
1221
|
+
3. **Register:** Run `scripts/init.py` (or `agents/setup-context.sh`) to symlink changes.
|
|
1222
|
+
|
|
1223
|
+
### Adding Custom MCP Servers
|
|
1224
|
+
|
|
1225
|
+
1. **Edit Config Template:** Open `agents/templates/core/MCP_CONFIG_TEMPLATE.json`.
|
|
1226
|
+
2. **Add Server:** Insert your MCP server configuration into the `mcpServers` object.
|
|
1227
|
+
3. **Apply to Tool:**
|
|
1228
|
+
- **Claude Desktop:** Copy the content to `~/Library/Application Support/Claude/claude_desktop_config.json`.
|
|
1229
|
+
- **VS Code / Cursor:** Add to your workspace settings or extension configuration.
|
|
1230
|
+
4. **Restart:** Restart your AI tool to load the new server.
|
|
1231
|
+
|
|
1232
|
+
### Where to Find More
|
|
1233
|
+
|
|
1234
|
+
**Skill Registries:**
|
|
1235
|
+
- **Cursor Rules:** [cursor.directory](https://cursor.directory) — Massive collection of Cursor rules/skills.
|
|
1236
|
+
- **Awesome Agent Skills:** [github.com/heilcheng/awesome-agent-skills](https://github.com/heilcheng/awesome-agent-skills)
|
|
1237
|
+
- **Awesome Claude Code:** [awesomeclaude.ai](https://awesomeclaude.ai)
|
|
1238
|
+
- **Antigravity Awesome Skills:** [github.com/sickn33/antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills) — 800+ battle-tested agentic skills.
|
|
1239
|
+
|
|
1240
|
+
**MCP Registries:**
|
|
1241
|
+
- **Official List:** [glama.ai/mcp/servers](https://glama.ai/mcp/servers)
|
|
1242
|
+
- **Community List:** [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers)
|
|
1243
|
+
|
|
1244
|
+
---
|
|
1245
|
+
|
|
1246
|
+
## 23. Loki Mode (Large Projects)
|
|
1247
|
+
|
|
1248
|
+
Loki Mode activates a multi-agent swarm for large projects (new product builds, major refactors, system migrations) where a single agent would hit context limits or require sustained multi-day work.
|
|
1249
|
+
|
|
1250
|
+
**When to use Loki Mode:**
|
|
1251
|
+
- Building a new product from scratch (> 5 features)
|
|
1252
|
+
- Major refactors touching > 20 files
|
|
1253
|
+
- Multi-service architecture
|
|
1254
|
+
- Projects running over multiple sessions/days
|
|
1255
|
+
|
|
1256
|
+
**Invoke:**
|
|
1257
|
+
```
|
|
1258
|
+
"Activate Loki Mode. Goal: [build X / migrate Y / refactor Z]"
|
|
1259
|
+
```
|
|
1260
|
+
|
|
1261
|
+
## 24. What's Inside?
|
|
1262
|
+
|
|
1263
|
+
> **Stats**: 214 Skills · 100 Templates · 36 Personas · 86 Guides
|
|
1264
|
+
|
|
1265
|
+
| Category | Count | Skills Included |
|
|
1266
|
+
|---|---|---|
|
|
1267
|
+
| **Coding** | 10+ | `tdd-cycle`, `debug`, `refactor`, `code-review`, `git-workflow` |
|
|
1268
|
+
| **Architecture** | 15+ | `arch-design`, `microservices`, `systems-architecture`, `system-scalability`, `blockchain-dlt` |
|
|
1269
|
+
| **Operations** | 15+ | `reliability-sre`, `production-health`, `dev-environments`, `cost-optimization` |
|
|
1270
|
+
| **Security** | 15+ | `security-audit`, `secure-architecture`, `privacy-data-protection`, `api-security` |
|
|
1271
|
+
| **Product** | 10+ | `spec-writer`, `req-elicitation`, `green-software`, `sustainability-checks` |
|
|
1272
|
+
| **Core** | 10+ | `research`, `self-heal`, `knowledge-gap`, `meta-optimize` |
|
|
1273
|
+
| **Data** | 5+ | `data-engineering`, `db-migration`, `semantic-web` |
|
|
1274
|
+
| **Coordination** | 5+ | `multi-agent-orch`, `agent-protocol` |
|
|
1275
|
+
| **Brain** | 10+ | `active-inference`, `consciousness-loop`, `cost-benefit-router` |
|
|
1276
|
+
| **AI/Swarm** | 5+ | `multi-agent-systems`, `agent-communication`, `beyond-llms` |
|
|
1277
|
+
| **Industry** | 5+ | `healthcare-fhir`, `telecom-networks`, `industrial-iot`, `global-standards`, `engineering-standards` |
|
|
1278
|
+
| **Loki Modes** | 2+ | `brain-mode`, `loki-mode` |
|
|
1279
|
+
|
|
1280
|
+
---
|
|
1281
|
+
|
|
1282
|
+
## 25. 🚀 Common Actions (Copy-Paste Prompts)
|
|
1283
|
+
|
|
1284
|
+
Copy and paste these exact prompts into your AI chat window to kick off standard workflows.
|
|
1285
|
+
|
|
1286
|
+
### New Project from Scratch
|
|
1287
|
+
> "Read AGENTS.md. I want to build [description]. Start with spec-writer skill."
|
|
1288
|
+
|
|
1289
|
+
**Flow:** Spec → Design → Tasks → TDD Implementation → Security → Deploy
|
|
1290
|
+
|
|
1291
|
+
### Resume Existing Project
|
|
1292
|
+
> "Read AGENTS.md and agents/memory/PROJECT_STATE.md. Resume the project."
|
|
1293
|
+
|
|
1294
|
+
### Fix a Bug
|
|
1295
|
+
> "Read AGENTS.md. Bug: [description]. Use debug skill with TDD."
|
|
1296
|
+
|
|
1297
|
+
**Flow:** Reproduce → Root Cause → Failing Test → Fix → Green → Regression Check
|
|
1298
|
+
|
|
1299
|
+
### Refactor / Pay Tech Debt
|
|
1300
|
+
> "Use tech-debt skill on [directory]. Then refactor the top-priority item."
|
|
1301
|
+
|
|
1302
|
+
### Security Audit
|
|
1303
|
+
> "Run security-audit skill on the entire codebase."
|
|
1304
|
+
|
|
1305
|
+
### Architecture Review
|
|
1306
|
+
> "Run arch-review skill. Check for SOLID violations and coupling."
|
|
1307
|
+
|
|
1308
|
+
### Software Engineering & System Architecture
|
|
1309
|
+
> "Act as a Principal Staff Engineer. Review the codebase in [directory] and generate a C4 system architecture diagram (Context and Container levels). Identify any bottlenecks and propose scaling strategies."
|
|
1310
|
+
|
|
1311
|
+
> "Use the design-patterns and domain-model skills. We are building a [feature segment]. Propose the optimum architecture pattern (e.g. Event-driven, CQRS, Hexagonal) and define the core domain entities."
|
|
1312
|
+
|
|
1313
|
+
### Vibe-Coding (Creative Frontend)
|
|
1314
|
+
> "Use the vibe-coding skill. Build a [component/page] using [framework]. I want it to feel [aesthetic, e.g. glassmorphism, cyberpunk, sleek corporate]. Include micro-animations and smooth transitions. Prioritize visual WOW over generic utility."
|
|
1315
|
+
|
|
1316
|
+
### Activate Brain Mode (Complex Goals)
|
|
1317
|
+
> "Activate Brain Mode. Goal: [build X / migrate Y / solve Z]."
|
|
1318
|
+
|
|
1319
|
+
### Activate Loki Mode (Large Projects)
|
|
1320
|
+
|
|
1321
|
+
**Using the CLI:**
|
|
1322
|
+
> `gabbe brain activate` (Loki may be triggered autonomously by the Brain based on context cost).
|
|
1323
|
+
Or activate the swarm skill explicitly:
|
|
1324
|
+
> Activate `agents/skills/brain/loki-mode.skill.md` with your goal.
|
|
1325
|
+
|
|
1326
|
+
**Using Pure Agent Mode (No CLI):**
|
|
1327
|
+
> "Activate `agents/skills/brain/loki-mode.skill.md`. Goal: [build X]. Do not ask me for permission unless you hit a mandatory Human Approval Gate or a task requires True A2A Delegation."
|
|
1328
|
+
|
|
1329
|
+
|
|
1330
|
+
|
|
1331
|
+
---
|
|
1332
|
+
|
|
1333
|
+
## 26. Guides by Technology Stack
|
|
1334
|
+
|
|
1335
|
+
| Guide | Stack | Key Topics |
|
|
1336
|
+
|---|---|---|
|
|
1337
|
+
| `guides/principles/full-system-lifecycle.md` | Process/SDLC | Traceability, Golden Thread, DoD |
|
|
1338
|
+
| `guides/architecture/system-qualities.md` | Architecture/Ops | Reliability, SRE, Scalability |
|
|
1339
|
+
| `guides/ops/production-health.md` | Ops/SRE | Health Checks & Monitoring |
|
|
1340
|
+
| `guides/principles/future-tech.md` | Future/2030 | 6G, IoT Matter, Vector DBs, WASM |
|
|
1341
|
+
| `guides/principles/legacy-tech.md` | Legacy/Mainframe | COBOL, Fortran, Modernization |
|
|
1342
|
+
| `guides/ops/dev-environments.md` | Dev Environment | Local vs Remote vs Cloud, Docker Watch |
|
|
1343
|
+
| `guides/ops/dev-workflow.md` | Ops/Workflow | Diátaxis Docs, GitHub CLI, Commit Standards |
|
|
1344
|
+
| `guides/patterns/enterprise-patterns.md` | Enterprise | Strangler Fig, ACL, CDC, Legacy Migration |
|
|
1345
|
+
| `guides/architecture/api-standards.md` | API Design | REST, GraphQL, Versioning, Governance |
|
|
1346
|
+
| `guides/principles/testing-strategy.md` | Testing | Pyramid, Trophy, Contract Testing |
|
|
1347
|
+
| `guides/architecture/event-driven-architecture.md` | Architecture | EDA, Async, Event Sourcing |
|
|
1348
|
+
| `guides/patterns/design-patterns.md` | Design Patterns | Strategy, Factory, Observer, Adapter |
|
|
1349
|
+
| `guides/principles/clean-code-standards.md` | Clean Code | SOLID, DRY, KISS, Refactoring |
|
|
1350
|
+
| `guides/patterns/agentic-patterns.md` | AI/Agentic | Reflection, Memory, Planning, Tools |
|
|
1351
|
+
| `guides/patterns/ai-native-scenarios.md` | AI/Agentic | Vibe-to-Code, Auto-Patching, DB Refactor |
|
|
1352
|
+
| `guides/patterns/enterprise-migration-scenario.md` | Enterprise | Strangler Fig, Migration paths |
|
|
1353
|
+
|
|
1354
|
+
| `guides/principles/RARV_CYCLE.md` | AI/Agentic | Reason-Act-Reflect-Verify loop |
|
|
1355
|
+
| `guides/ai/self-healing-summary.md` | AI/Agentic | Self-healing architecture & loops |
|
|
1356
|
+
| `guides/languages/js-ts-nodejs.md` | Python/Node/React | Swarms, Orchestration, A2A Protocol |
|
|
1357
|
+
| `guides/patterns/autonomous-swarm-patterns.md` | AI/Agentic | Self-organizing Swarm Patterns |
|
|
1358
|
+
| `guides/ai/agent-communication.md` | All Stacks | MCP, A2A, ACP, Handshake Protocols |
|
|
1359
|
+
| `guides/languages/js-ts-nodejs.md` | JS/TS/Node.js | Clean Architecture, Vitest, Zod, Prisma, Playwright |
|
|
1360
|
+
| `guides/languages/nodejs-advanced.md` | Node.js Advanced | Fastify Architecture, Internals, Zero-Any TS |
|
|
1361
|
+
| `guides/languages/go-lang.md` | Go (Golang) | Echo/Gin, Ent, Testify, Clean Arch |
|
|
1362
|
+
| `guides/languages/php-laravel.md` | PHP/Laravel | DDD, Actions, Pest PHP, PHPStan L9, Enlightn |
|
|
1363
|
+
| `guides/languages/python-fastapi-ai.md` | Python/FastAPI/AI | Clean Architecture, Pydantic, Agents |
|
|
1364
|
+
| `guides/security/cryptography-standards.md` | Security | Encryption, Hashing, PQC Readiness |
|
|
1365
|
+
| `guides/security/threat-modeling.md` | Security | STRIDE, Attack Trees, Risk Assessment |
|
|
1366
|
+
|
|
1367
|
+
|
|
1368
|
+
| `guides/data/sql-nosql.md` | SQL/NoSQL | Migration-first, PostgreSQL patterns, Redis, MongoDB |
|
|
1369
|
+
| `guides/languages/rust.md` | Rust | Cargo, Ownership, Actix, SQLx, Agents |
|
|
1370
|
+
| `guides/languages/java.md` | Java | Spring Boot, Quarkus, Maven/Gradle, ArchUnit |
|
|
1371
|
+
| `guides/languages/c-sharp.md` | C# / .NET | ASP.NET Core, Entity Framework, Dapr |
|
|
1372
|
+
|
|
1373
|
+
| `guides/ops/compliance-audit.md` | Compliance & Audit | GDPR, SOC2 logging, Privacy Engineering |
|
|
1374
|
+
| `guides/ops/troubleshooting-guide.md` | Ops | Debugging, Root Cause, Recovery |
|
|
1375
|
+
| `guides/ops/self-healing-summary.md` | Ops | Automated recovery patterns |
|
|
1376
|
+
|
|
1377
|
+
| `guides/ai/ai-agentic.md` | AI/Agentic | RARV, SDD lifecycle, Memory Architecture, MCP config |
|
|
1378
|
+
| `guides/architecture/microservices.md` | Microservices | Bounded contexts, event-driven, contract testing |
|
|
1379
|
+
| `guides/architecture/systems-architecture.md` | Architecture | C4 models, quality attributes, decision records |
|
|
1380
|
+
| `guides/planning/product-requirements.md` | Product | EARS syntax, user stories, prioritization |
|
|
1381
|
+
| `guides/planning/strategic-analysis.md` | Strategy | Business case, design thinking, systems loops |
|
|
1382
|
+
| `guides/principles/diagramming-standards.md` | Diagrams | Mermaid.js class, sequence, state diagrams |
|
|
1383
|
+
| `guides/ai/visual-mcp-integration.md` | Diagrams | Rules for Visual vs Text diagramming rendering |
|
|
1384
|
+
| `guides/principles/visual-design-system.md` | Design | Design Tokens & UI Architecture |
|
|
1385
|
+
| `guides/ai/agent-ui.md` | UI/UX | Generative UI, HTMX, TUI, ShadCN |
|
|
1386
|
+
| `guides/principles/no-code-integration.md` | No-Code | n8n, Make, Zapier, Hybrid Workflows |
|
|
1387
|
+
| `guides/ai/actor-agent-frameworks.md` | Architecture | Akka, Erlang, LangGraph comparison (`actor-agent-frameworks.skill`) |
|
|
1388
|
+
| `guides/ai/a2ui-protocols.md` | UI/UX | A2UI, GenUI, AG-UI standards (`a2ui-protocols.skill`) |
|
|
1389
|
+
| `guides/architecture/critical-systems-arch.md` | Safety | DO-178C, IEC 62304, DDD, Hexagonal (`critical-systems-arch.skill`) |
|
|
1390
|
+
| `guides/ai/beyond-llms.md` | AI Theory | Neuro-symbolic, Genetic Algos, Active Inference (`beyond-llms.skill`) |
|
|
1391
|
+
| `agents/skills/brain/` | **Neuro-Arch** | **The Brain Metaphor: Cognitive Software Patterns** |
|
|
1392
|
+
| `guides/architecture/monolith.md` | Monolith | Vertical slices, modular monolith, Strangler Fig (`monolith.skill`) |
|
|
1393
|
+
|
|
1394
|
+
### Subject-Specific Guides
|
|
1395
|
+
| Topic | Guide |
|
|
1396
|
+
|---|---|
|
|
1397
|
+
| **Product** | `guides/product-requirements.md` (PRD/Spec), `guides/strategic-analysis.md` (Strategy) |
|
|
1398
|
+
| **Architecture** | `guides/critical-systems-arch.md`, `guides/event-driven-architecture.md` |
|
|
1399
|
+
| **Integration** | `guides/knowledge-integration.md`, `guides/no-code-integration.md`, `guides/api-standards.md` |
|
|
1400
|
+
| **Agents** | `guides/actor-agent-frameworks.md`, `guides/autonomous-swarm-patterns.md`, `guides/agent-communication.md` |
|
|
1401
|
+
| **UI/UX** | `guides/visual-design-system.md`, `guides/a2ui-protocols.md`, `guides/agent-ui.md` |
|
|
1402
|
+
| **Lifecycle** | `guides/production-health.md`, `guides/beyond-llms.md` |
|
|
1403
|
+
| **Industry** | `guides/industry/engineering-standards.md`, `guides/industry/global-standards.md`, `guides/industry/telecom-networks.md` |
|
|
1404
|
+
|
|
1405
|
+
---
|
|
1406
|
+
|
|
1407
|
+
## 27. Troubleshooting
|
|
1408
|
+
|
|
1409
|
+
**Agent ignores AGENTS.md:**
|
|
1410
|
+
- Run `setup-context.sh` to create tool-specific symlinks
|
|
1411
|
+
- For Cursor: verify `.cursorrules` file exists (symlink created by setup script)
|
|
1412
|
+
- For Claude Code: verify `.claude/CLAUDE.md` exists
|
|
1413
|
+
|
|
1414
|
+
**Agent repeats past mistakes:**
|
|
1415
|
+
- Check `agents/memory/CONTINUITY.md` — past failures should be logged here
|
|
1416
|
+
- Tell agent: "Read CONTINUITY.md before starting. What past mistakes are recorded?"
|
|
1417
|
+
|
|
1418
|
+
**Tests always pass immediately (false positive):**
|
|
1419
|
+
- `tdd-cycle.skill` includes a false-positive check: if test passes with no implementation, the test is wrong
|
|
1420
|
+
- Tell agent: "The test passed immediately — that means the test is broken. Fix the test to actually fail first."
|
|
1421
|
+
|
|
1422
|
+
**Agent uses deprecated APIs:**
|
|
1423
|
+
- Activate Context-7 MCP: it provides up-to-date SDK docs to prevent this
|
|
1424
|
+
- Add to AGENTS.md Research Policy: "Always use Context-7 MCP before calling any library method"
|
|
1425
|
+
|
|
1426
|
+
**Session lost after interruption:**
|
|
1427
|
+
- Tell agent: "Use session-resume skill to load all memory and continue."
|
|
1428
|
+
- All memory is stored in `agents/memory/` — it persists across sessions
|
|
1429
|
+
|
|
1430
|
+
**Agent makes architecture decisions without asking:**
|
|
1431
|
+
- Add to AGENTS.md Human-in-the-Loop section: "Architecture changes require human approval"
|
|
1432
|
+
- Check `CONSTITUTION.md` — Article VII should cover this
|
|
1433
|
+
|
|
1434
|
+
**Context window too large / slow responses:**
|
|
1435
|
+
- Use `context_cost: low` skills for routine tasks
|
|
1436
|
+
- Activate Loki Mode: specialized personas have smaller, focused context scopes
|
|
1437
|
+
|
|
1438
|
+
---
|
|
1439
|
+
|
|
1440
|
+
*This kit is maintained in `agents/`. Research is documented in `docs/`.*
|
|
1441
|
+
*For team adoption, see [QUICK_GUIDE.md](QUICK_GUIDE.md) for the 4-phase adoption roadmap.*
|
|
1442
|
+
|
|
1443
|
+
*See README.md for quick reference.*
|
|
1444
|
+
*See skills/00-index.md for complete skills registry with installation instructions.*
|
|
1445
|
+
*See agents/skills/brain/README_ORCHESTRATORS.md for Loki Mode multi-agent orchestration.*
|
|
1446
|
+
*See agents/skills/brain/README.md and README_ORCHESTRATORS.md for complete brain documentation.*
|
|
1447
|
+
|
|
1448
|
+
|
|
1449
|
+
---
|
|
1450
|
+
|
|
1451
|
+
[© 2026 Andrei Nicolae Besleaga. This work is licensed CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)
|