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
package/bin/install.js
ADDED
|
@@ -0,0 +1,572 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
//
|
|
4
|
+
// GABBE installer (Python-independent).
|
|
5
|
+
//
|
|
6
|
+
// This is the PRIMARY installer for `npx gabbe-kit init`. It bundles the Markdown
|
|
7
|
+
// kit (agents/, docs/) and wires it into the current project using only the
|
|
8
|
+
// Node standard library -- no npm dependencies, no Python required.
|
|
9
|
+
//
|
|
10
|
+
// Conventions mirror scripts/init.py and agents/scripts/compile_skills.py:
|
|
11
|
+
// - safe_slug() -> compile_skills.py safe_slug()
|
|
12
|
+
// - .agents/skills/<slug>/SKILL.md (agentskills.io "Universal" target)
|
|
13
|
+
// - root AGENTS.md -> agents.md open standard
|
|
14
|
+
// - per-agent rule files -> .claude/CLAUDE.md, .cursorrules, etc.
|
|
15
|
+
//
|
|
16
|
+
// If `python3` is available the full interactive wizard (scripts/init.py) can
|
|
17
|
+
// be delegated to with `--wizard`, but the Node path works WITHOUT Python.
|
|
18
|
+
|
|
19
|
+
'use strict';
|
|
20
|
+
|
|
21
|
+
const fs = require('fs');
|
|
22
|
+
const path = require('path');
|
|
23
|
+
const os = require('os');
|
|
24
|
+
const { spawnSync } = require('child_process');
|
|
25
|
+
|
|
26
|
+
// ---------------------------------------------------------------------------
|
|
27
|
+
// Paths / colors
|
|
28
|
+
// ---------------------------------------------------------------------------
|
|
29
|
+
|
|
30
|
+
// The bundled kit lives one level up from bin/ (the package root).
|
|
31
|
+
const KIT_ROOT = path.resolve(__dirname, '..');
|
|
32
|
+
const SOURCE_AGENTS_DIR = path.join(KIT_ROOT, 'agents');
|
|
33
|
+
const SOURCE_DOCS_DIR = path.join(KIT_ROOT, 'docs');
|
|
34
|
+
const PROJECT_ROOT = process.cwd();
|
|
35
|
+
|
|
36
|
+
const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
|
|
37
|
+
const c = (code, s) => (useColor ? `[${code}m${s}[0m` : s);
|
|
38
|
+
const green = (s) => c('0;32', s);
|
|
39
|
+
const yellow = (s) => c('1;33', s);
|
|
40
|
+
const blue = (s) => c('0;34', s);
|
|
41
|
+
const red = (s) => c('0;31', s);
|
|
42
|
+
|
|
43
|
+
function log(msg) {
|
|
44
|
+
process.stdout.write(msg + '\n');
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
// ---------------------------------------------------------------------------
|
|
48
|
+
// Agent registry: canonical name -> CLI alias(es) accepted in --agents
|
|
49
|
+
// ---------------------------------------------------------------------------
|
|
50
|
+
|
|
51
|
+
const AGENT_ALIASES = {
|
|
52
|
+
claude: 'Claude Code',
|
|
53
|
+
'claude-code': 'Claude Code',
|
|
54
|
+
cursor: 'Cursor',
|
|
55
|
+
windsurf: 'Windsurf',
|
|
56
|
+
cline: 'Cline',
|
|
57
|
+
aider: 'Aider',
|
|
58
|
+
devin: 'Devin / Cognition',
|
|
59
|
+
cognition: 'Devin / Cognition',
|
|
60
|
+
gemini: 'Gemini',
|
|
61
|
+
antigravity: 'Antigravity',
|
|
62
|
+
opencode: 'OpenCode',
|
|
63
|
+
zed: 'Zed',
|
|
64
|
+
continue: 'Continue',
|
|
65
|
+
roo: 'Roo Code',
|
|
66
|
+
'roo-code': 'Roo Code',
|
|
67
|
+
kilo: 'Kilo Code',
|
|
68
|
+
'kilo-code': 'Kilo Code',
|
|
69
|
+
codex: 'OpenAI / Codex',
|
|
70
|
+
openai: 'OpenAI / Codex',
|
|
71
|
+
copilot: 'GitHub Copilot',
|
|
72
|
+
'github-copilot': 'GitHub Copilot',
|
|
73
|
+
vscode: 'VS Code',
|
|
74
|
+
'vs-code': 'VS Code',
|
|
75
|
+
};
|
|
76
|
+
|
|
77
|
+
// ---------------------------------------------------------------------------
|
|
78
|
+
// Helpers
|
|
79
|
+
// ---------------------------------------------------------------------------
|
|
80
|
+
|
|
81
|
+
// Mirror of compile_skills.py safe_slug(): lowercase, collapse non [a-z0-9]
|
|
82
|
+
// runs into single hyphens, strip leading/trailing hyphens, prevent traversal.
|
|
83
|
+
function safeSlug(rawName, fallback) {
|
|
84
|
+
let slug = (rawName || '').toLowerCase().trim();
|
|
85
|
+
slug = slug.replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
|
|
86
|
+
if (!slug || slug === '.' || slug === '..') {
|
|
87
|
+
const fb = String(fallback || 'skill')
|
|
88
|
+
.toLowerCase()
|
|
89
|
+
.replace(/[^a-z0-9]+/g, '-')
|
|
90
|
+
.replace(/^-+|-+$/g, '');
|
|
91
|
+
slug = fb || 'skill';
|
|
92
|
+
}
|
|
93
|
+
return slug;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
// Minimal YAML frontmatter reader: returns { name, description } parsed from a
|
|
97
|
+
// leading `---` block. Enough for slug + description; we never re-serialize.
|
|
98
|
+
function parseFrontmatter(content) {
|
|
99
|
+
const meta = {};
|
|
100
|
+
if (!content.startsWith('---')) return meta;
|
|
101
|
+
const end = content.indexOf('---', 3);
|
|
102
|
+
if (end === -1) return meta;
|
|
103
|
+
const block = content.slice(3, end);
|
|
104
|
+
for (const line of block.split('\n')) {
|
|
105
|
+
const idx = line.indexOf(':');
|
|
106
|
+
if (idx === -1) continue;
|
|
107
|
+
const key = line.slice(0, idx).trim();
|
|
108
|
+
let val = line.slice(idx + 1).trim();
|
|
109
|
+
// Strip a single pair of surrounding quotes.
|
|
110
|
+
if (
|
|
111
|
+
(val.startsWith('"') && val.endsWith('"')) ||
|
|
112
|
+
(val.startsWith("'") && val.endsWith("'"))
|
|
113
|
+
) {
|
|
114
|
+
val = val.slice(1, -1);
|
|
115
|
+
}
|
|
116
|
+
if (key) meta[key] = val;
|
|
117
|
+
}
|
|
118
|
+
return meta;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
// Idempotent: inject `gabbe-schema-version: 1` into a leading frontmatter block
|
|
122
|
+
// (matches compile_skills.py inject_schema_version()).
|
|
123
|
+
const GABBE_SCHEMA_VERSION = 1;
|
|
124
|
+
function injectSchemaVersion(content) {
|
|
125
|
+
if (content.includes('gabbe-schema-version:')) return content;
|
|
126
|
+
if (content.startsWith('---')) {
|
|
127
|
+
const end = content.indexOf('---', 3);
|
|
128
|
+
if (end !== -1) {
|
|
129
|
+
const head = content.slice(0, 3);
|
|
130
|
+
const block = content.slice(3, end).replace(/\n+$/, '');
|
|
131
|
+
const tail = content.slice(end);
|
|
132
|
+
return head + block + `\ngabbe-schema-version: ${GABBE_SCHEMA_VERSION}\n` + tail;
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
return content;
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
function walk(dir) {
|
|
139
|
+
const out = [];
|
|
140
|
+
let entries;
|
|
141
|
+
try {
|
|
142
|
+
entries = fs.readdirSync(dir, { withFileTypes: true });
|
|
143
|
+
} catch (e) {
|
|
144
|
+
return out;
|
|
145
|
+
}
|
|
146
|
+
for (const entry of entries) {
|
|
147
|
+
const full = path.join(dir, entry.name);
|
|
148
|
+
if (entry.isDirectory()) {
|
|
149
|
+
out.push(...walk(full));
|
|
150
|
+
} else if (entry.isFile()) {
|
|
151
|
+
out.push(full);
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
return out;
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
// PRESERVE_FILES mirrors init.py: never clobber user-authored content.
|
|
158
|
+
const PRESERVE_FILES = new Set([
|
|
159
|
+
'AGENTS.md',
|
|
160
|
+
'CONSTITUTION.md',
|
|
161
|
+
'TASKS.md',
|
|
162
|
+
'policies.yml',
|
|
163
|
+
'config.json',
|
|
164
|
+
]);
|
|
165
|
+
|
|
166
|
+
function shouldPreserve(relPath, fileName) {
|
|
167
|
+
const parts = relPath.split(path.sep);
|
|
168
|
+
if (parts.includes('memory')) return true;
|
|
169
|
+
if (parts.includes('project')) return true;
|
|
170
|
+
if (PRESERVE_FILES.has(fileName)) return true;
|
|
171
|
+
if (fileName.startsWith('PROJECT') && fileName.endsWith('.md')) return true;
|
|
172
|
+
return false;
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
// Copy a directory tree without overwriting preserved user files.
|
|
176
|
+
function safeCopyTree(srcRoot, dstRoot) {
|
|
177
|
+
if (!fs.existsSync(srcRoot)) return 0;
|
|
178
|
+
let copied = 0;
|
|
179
|
+
for (const src of walk(srcRoot)) {
|
|
180
|
+
const rel = path.relative(srcRoot, src);
|
|
181
|
+
const dst = path.join(dstRoot, rel);
|
|
182
|
+
const fileName = path.basename(src);
|
|
183
|
+
if (fs.existsSync(dst) && shouldPreserve(rel, fileName)) {
|
|
184
|
+
continue;
|
|
185
|
+
}
|
|
186
|
+
fs.mkdirSync(path.dirname(dst), { recursive: true });
|
|
187
|
+
fs.copyFileSync(src, dst);
|
|
188
|
+
copied += 1;
|
|
189
|
+
}
|
|
190
|
+
return copied;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
// Wire a rule file pointing at the kit's AGENTS.md. Prefer a relative symlink
|
|
194
|
+
// (like init.py); fall back to a copy on platforms/filesystems that refuse
|
|
195
|
+
// symlinks (e.g. Windows without privileges). Backs up existing non-symlink.
|
|
196
|
+
function wireAgentsLink(target, sourceAgentsMd) {
|
|
197
|
+
fs.mkdirSync(path.dirname(target), { recursive: true });
|
|
198
|
+
try {
|
|
199
|
+
const st = fs.lstatSync(target);
|
|
200
|
+
if (st.isSymbolicLink()) {
|
|
201
|
+
fs.unlinkSync(target);
|
|
202
|
+
} else {
|
|
203
|
+
const backup = target + '.bak';
|
|
204
|
+
fs.renameSync(target, backup);
|
|
205
|
+
log(` ${yellow('!')} Backed up existing ${path.basename(target)} -> ${path.basename(backup)}`);
|
|
206
|
+
}
|
|
207
|
+
} catch (e) {
|
|
208
|
+
/* target does not exist */
|
|
209
|
+
}
|
|
210
|
+
const linkPath = path.relative(path.dirname(target), sourceAgentsMd);
|
|
211
|
+
try {
|
|
212
|
+
fs.symlinkSync(linkPath, target);
|
|
213
|
+
log(` ${green('✓')} Linked ${path.relative(PROJECT_ROOT, target)} -> ${linkPath}`);
|
|
214
|
+
} catch (e) {
|
|
215
|
+
fs.copyFileSync(sourceAgentsMd, target);
|
|
216
|
+
log(` ${green('✓')} Copied ${path.relative(PROJECT_ROOT, target)} (symlink fallback)`);
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
// Emit the universal .agents/skills/<slug>/SKILL.md tree (agentskills.io).
|
|
221
|
+
// Reads every agents/skills/**/*.skill.md and writes a real SKILL.md file.
|
|
222
|
+
function emitUniversalSkills(skillsSrcDir, targetSkillsDir) {
|
|
223
|
+
fs.mkdirSync(targetSkillsDir, { recursive: true });
|
|
224
|
+
let count = 0;
|
|
225
|
+
for (const skillFile of walk(skillsSrcDir)) {
|
|
226
|
+
if (!skillFile.endsWith('.skill.md')) continue;
|
|
227
|
+
const content = fs.readFileSync(skillFile, 'utf8');
|
|
228
|
+
const meta = parseFrontmatter(content);
|
|
229
|
+
const fallback = path.basename(skillFile).replace(/\.skill\.md$/, '');
|
|
230
|
+
const slug = safeSlug(meta.name, fallback);
|
|
231
|
+
const folder = path.join(targetSkillsDir, slug);
|
|
232
|
+
fs.mkdirSync(folder, { recursive: true });
|
|
233
|
+
fs.writeFileSync(path.join(folder, 'SKILL.md'), injectSchemaVersion(content));
|
|
234
|
+
count += 1;
|
|
235
|
+
}
|
|
236
|
+
return count;
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
// Emit Cursor flat .mdc rules (.cursor/rules/<slug>.mdc) -- mirrors the Cursor
|
|
240
|
+
// branch of compile_skills.py.
|
|
241
|
+
function emitCursorRules(skillsSrcDir, cursorRulesDir) {
|
|
242
|
+
fs.mkdirSync(cursorRulesDir, { recursive: true });
|
|
243
|
+
let count = 0;
|
|
244
|
+
for (const skillFile of walk(skillsSrcDir)) {
|
|
245
|
+
if (!skillFile.endsWith('.skill.md')) continue;
|
|
246
|
+
const content = fs.readFileSync(skillFile, 'utf8');
|
|
247
|
+
const meta = parseFrontmatter(content);
|
|
248
|
+
const fallback = path.basename(skillFile).replace(/\.skill\.md$/, '');
|
|
249
|
+
const slug = safeSlug(meta.name, fallback);
|
|
250
|
+
const desc = meta.description || `Skill for ${meta.name || slug}`;
|
|
251
|
+
let body = content;
|
|
252
|
+
if (content.startsWith('---')) {
|
|
253
|
+
const end = content.indexOf('---', 3);
|
|
254
|
+
if (end !== -1) body = content.slice(end + 3).replace(/^\s+/, '');
|
|
255
|
+
}
|
|
256
|
+
const cursorFm =
|
|
257
|
+
'---\n' +
|
|
258
|
+
`description: ${desc}\n` +
|
|
259
|
+
'alwaysApply: false\n' +
|
|
260
|
+
`gabbe-schema-version: ${GABBE_SCHEMA_VERSION}\n` +
|
|
261
|
+
'---\n';
|
|
262
|
+
fs.writeFileSync(path.join(cursorRulesDir, `${slug}.mdc`), cursorFm + '\n' + body);
|
|
263
|
+
count += 1;
|
|
264
|
+
}
|
|
265
|
+
return count;
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
function writeJsonIfAbsent(filePath, obj) {
|
|
269
|
+
if (fs.existsSync(filePath)) return false;
|
|
270
|
+
fs.mkdirSync(path.dirname(filePath), { recursive: true });
|
|
271
|
+
fs.writeFileSync(filePath, JSON.stringify(obj, null, 2) + '\n');
|
|
272
|
+
return true;
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
// ---------------------------------------------------------------------------
|
|
276
|
+
// Per-agent wiring (mirrors scripts/init.py Step 5 conventions)
|
|
277
|
+
// ---------------------------------------------------------------------------
|
|
278
|
+
|
|
279
|
+
function wireAgent(agent, ctx) {
|
|
280
|
+
const { skillsSrc, agentsMdSrc } = ctx;
|
|
281
|
+
switch (agent) {
|
|
282
|
+
case 'Claude Code':
|
|
283
|
+
wireAgentsLink(path.join(PROJECT_ROOT, '.claude', 'CLAUDE.md'), agentsMdSrc);
|
|
284
|
+
emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.claude', 'skills'));
|
|
285
|
+
log(` ${green('✓')} Wired Claude Code (.claude/CLAUDE.md + .claude/skills)`);
|
|
286
|
+
break;
|
|
287
|
+
case 'Cursor':
|
|
288
|
+
wireAgentsLink(path.join(PROJECT_ROOT, '.cursorrules'), agentsMdSrc);
|
|
289
|
+
emitCursorRules(skillsSrc, path.join(PROJECT_ROOT, '.cursor', 'rules'));
|
|
290
|
+
log(` ${green('✓')} Wired Cursor (.cursorrules + .cursor/rules)`);
|
|
291
|
+
break;
|
|
292
|
+
case 'Windsurf':
|
|
293
|
+
wireAgentsLink(path.join(PROJECT_ROOT, '.windsurfrules'), agentsMdSrc);
|
|
294
|
+
wireAgentsLink(path.join(PROJECT_ROOT, '.windsurf', 'skills', 'AGENTS.md'), agentsMdSrc);
|
|
295
|
+
emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.windsurf', 'skills'));
|
|
296
|
+
log(` ${green('✓')} Wired Windsurf (.windsurfrules + .windsurf/skills)`);
|
|
297
|
+
break;
|
|
298
|
+
case 'Cline':
|
|
299
|
+
wireAgentsLink(path.join(PROJECT_ROOT, '.clinerules'), agentsMdSrc);
|
|
300
|
+
emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.cline', 'skills'));
|
|
301
|
+
log(` ${green('✓')} Wired Cline (.clinerules + .cline/skills)`);
|
|
302
|
+
break;
|
|
303
|
+
case 'Devin / Cognition':
|
|
304
|
+
wireAgentsLink(path.join(PROJECT_ROOT, '.devinrules'), agentsMdSrc);
|
|
305
|
+
emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.devin', 'skills'));
|
|
306
|
+
log(` ${green('✓')} Wired Devin (.devinrules + .devin/skills)`);
|
|
307
|
+
break;
|
|
308
|
+
case 'Aider': {
|
|
309
|
+
const aiderConf = path.join(PROJECT_ROOT, '.aider.conf.yml');
|
|
310
|
+
if (!fs.existsSync(aiderConf)) {
|
|
311
|
+
fs.writeFileSync(aiderConf, 'read:\n - agents/AGENTS.md\n - agents/skills/\n');
|
|
312
|
+
log(` ${green('✓')} Wired .aider.conf.yml`);
|
|
313
|
+
} else {
|
|
314
|
+
log(` ${blue('→')} .aider.conf.yml exists, leaving as-is`);
|
|
315
|
+
}
|
|
316
|
+
break;
|
|
317
|
+
}
|
|
318
|
+
case 'Gemini': {
|
|
319
|
+
const geminiDir = path.join(PROJECT_ROOT, '.gemini');
|
|
320
|
+
fs.mkdirSync(geminiDir, { recursive: true });
|
|
321
|
+
const relAgents = path.relative(PROJECT_ROOT, agentsMdSrc);
|
|
322
|
+
const relSkills = path.relative(PROJECT_ROOT, skillsSrc);
|
|
323
|
+
writeJsonIfAbsent(path.join(geminiDir, 'settings.json'), {
|
|
324
|
+
agent_instructions_file: relAgents,
|
|
325
|
+
skills_directory: relSkills,
|
|
326
|
+
contextFileName: 'GEMINI.md',
|
|
327
|
+
'gabbe-schema-version': GABBE_SCHEMA_VERSION,
|
|
328
|
+
notes: 'Managed by gabbe (Node installer)',
|
|
329
|
+
});
|
|
330
|
+
wireAgentsLink(path.join(PROJECT_ROOT, 'GEMINI.md'), agentsMdSrc);
|
|
331
|
+
log(` ${green('✓')} Wired .gemini/settings.json + GEMINI.md`);
|
|
332
|
+
break;
|
|
333
|
+
}
|
|
334
|
+
case 'Antigravity':
|
|
335
|
+
emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.agents', 'skills'));
|
|
336
|
+
log(` ${green('✓')} Wired Antigravity (.agents/skills + root AGENTS.md)`);
|
|
337
|
+
break;
|
|
338
|
+
case 'OpenCode': {
|
|
339
|
+
const opencodeConf = path.join(PROJECT_ROOT, 'opencode.json');
|
|
340
|
+
writeJsonIfAbsent(opencodeConf, {
|
|
341
|
+
$schema: 'https://opencode.ai/config.json',
|
|
342
|
+
instructions: ['AGENTS.md', 'agents/skills/'],
|
|
343
|
+
});
|
|
344
|
+
emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.agents', 'skills'));
|
|
345
|
+
log(` ${green('✓')} Wired opencode.json + .agents/skills`);
|
|
346
|
+
break;
|
|
347
|
+
}
|
|
348
|
+
case 'Zed':
|
|
349
|
+
wireAgentsLink(path.join(PROJECT_ROOT, '.rules'), agentsMdSrc);
|
|
350
|
+
log(` ${green('✓')} Wired Zed (.rules)`);
|
|
351
|
+
break;
|
|
352
|
+
case 'Continue':
|
|
353
|
+
wireAgentsLink(path.join(PROJECT_ROOT, '.continue', 'rules', 'agents.md'), agentsMdSrc);
|
|
354
|
+
log(` ${green('✓')} Wired Continue (.continue/rules/agents.md)`);
|
|
355
|
+
break;
|
|
356
|
+
case 'Roo Code':
|
|
357
|
+
wireAgentsLink(path.join(PROJECT_ROOT, '.roo', 'rules', 'agents.md'), agentsMdSrc);
|
|
358
|
+
log(` ${green('✓')} Wired Roo Code (.roo/rules/agents.md)`);
|
|
359
|
+
break;
|
|
360
|
+
case 'Kilo Code':
|
|
361
|
+
wireAgentsLink(path.join(PROJECT_ROOT, '.kilocode', 'rules', 'agents.md'), agentsMdSrc);
|
|
362
|
+
log(` ${green('✓')} Wired Kilo Code (.kilocode/rules/agents.md)`);
|
|
363
|
+
break;
|
|
364
|
+
case 'OpenAI / Codex':
|
|
365
|
+
wireAgentsLink(path.join(PROJECT_ROOT, '.codex', 'AGENTS.md'), agentsMdSrc);
|
|
366
|
+
log(` ${green('✓')} Wired Codex (.codex/AGENTS.md)`);
|
|
367
|
+
break;
|
|
368
|
+
case 'GitHub Copilot':
|
|
369
|
+
wireAgentsLink(path.join(PROJECT_ROOT, '.github', 'copilot-instructions.md'), agentsMdSrc);
|
|
370
|
+
emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.github', 'skills'));
|
|
371
|
+
log(` ${green('✓')} Wired GitHub Copilot (.github/copilot-instructions.md + .github/skills)`);
|
|
372
|
+
break;
|
|
373
|
+
case 'VS Code':
|
|
374
|
+
emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.github', 'skills'));
|
|
375
|
+
log(` ${green('✓')} Wired VS Code (.github/skills)`);
|
|
376
|
+
break;
|
|
377
|
+
default:
|
|
378
|
+
log(` ${yellow('!')} Unknown agent "${agent}", skipped`);
|
|
379
|
+
}
|
|
380
|
+
}
|
|
381
|
+
|
|
382
|
+
// ---------------------------------------------------------------------------
|
|
383
|
+
// CLI
|
|
384
|
+
// ---------------------------------------------------------------------------
|
|
385
|
+
|
|
386
|
+
const USAGE = `gabbe - Generative Architectural Brain Base Engine (kit installer)
|
|
387
|
+
|
|
388
|
+
Usage:
|
|
389
|
+
gabbe init [options] Install the GABBE kit into the current directory
|
|
390
|
+
gabbe --help Show this help
|
|
391
|
+
|
|
392
|
+
Options:
|
|
393
|
+
--agents <list> Comma-separated agents to wire, e.g. claude,cursor,copilot.
|
|
394
|
+
Known: claude, cursor, windsurf, cline, aider, devin,
|
|
395
|
+
gemini, antigravity, opencode, zed, continue, roo, kilo,
|
|
396
|
+
codex, copilot, vscode.
|
|
397
|
+
--yes, -y Non-interactive: accept defaults, do not prompt.
|
|
398
|
+
--wizard Delegate to the full Python wizard (scripts/init.py) if
|
|
399
|
+
python3 is available (interactive, richer configuration).
|
|
400
|
+
--help, -h Show this help.
|
|
401
|
+
|
|
402
|
+
What it does (Node path, no Python required):
|
|
403
|
+
- Copies the bundled kit (agents/, docs/) into the current project.
|
|
404
|
+
- Writes a root AGENTS.md (agents.md open standard).
|
|
405
|
+
- Emits the universal .agents/skills/<slug>/SKILL.md tree.
|
|
406
|
+
- Wires per-agent rule files for any agents passed via --agents.
|
|
407
|
+
|
|
408
|
+
Examples:
|
|
409
|
+
npx gabbe-kit init --agents claude,cursor --yes
|
|
410
|
+
npx gabbe-kit init --wizard
|
|
411
|
+
`;
|
|
412
|
+
|
|
413
|
+
function parseArgs(argv) {
|
|
414
|
+
const opts = { command: null, agents: [], yes: false, wizard: false, help: false };
|
|
415
|
+
for (let i = 0; i < argv.length; i++) {
|
|
416
|
+
const a = argv[i];
|
|
417
|
+
if (a === 'init') {
|
|
418
|
+
opts.command = 'init';
|
|
419
|
+
} else if (a === '--help' || a === '-h') {
|
|
420
|
+
opts.help = true;
|
|
421
|
+
} else if (a === '--yes' || a === '-y') {
|
|
422
|
+
opts.yes = true;
|
|
423
|
+
} else if (a === '--wizard') {
|
|
424
|
+
opts.wizard = true;
|
|
425
|
+
} else if (a === '--agents') {
|
|
426
|
+
opts.agents = (argv[++i] || '').split(',');
|
|
427
|
+
} else if (a.startsWith('--agents=')) {
|
|
428
|
+
opts.agents = a.slice('--agents='.length).split(',');
|
|
429
|
+
} else if (a.startsWith('-')) {
|
|
430
|
+
log(red(`Unknown option: ${a}`));
|
|
431
|
+
opts.help = true;
|
|
432
|
+
}
|
|
433
|
+
}
|
|
434
|
+
return opts;
|
|
435
|
+
}
|
|
436
|
+
|
|
437
|
+
function resolveAgents(rawList) {
|
|
438
|
+
const resolved = [];
|
|
439
|
+
const seen = new Set();
|
|
440
|
+
for (const raw of rawList) {
|
|
441
|
+
const key = String(raw || '').trim().toLowerCase();
|
|
442
|
+
if (!key) continue;
|
|
443
|
+
const canonical = AGENT_ALIASES[key];
|
|
444
|
+
if (!canonical) {
|
|
445
|
+
log(` ${yellow('!')} Unknown agent "${raw}" -- skipping`);
|
|
446
|
+
continue;
|
|
447
|
+
}
|
|
448
|
+
if (!seen.has(canonical)) {
|
|
449
|
+
seen.add(canonical);
|
|
450
|
+
resolved.push(canonical);
|
|
451
|
+
}
|
|
452
|
+
}
|
|
453
|
+
return resolved;
|
|
454
|
+
}
|
|
455
|
+
|
|
456
|
+
function delegateToPython() {
|
|
457
|
+
const initPy = path.join(KIT_ROOT, 'scripts', 'init.py');
|
|
458
|
+
if (!fs.existsSync(initPy)) {
|
|
459
|
+
log(red(`Cannot find scripts/init.py at ${initPy}`));
|
|
460
|
+
return 1;
|
|
461
|
+
}
|
|
462
|
+
for (const py of ['python3', 'python']) {
|
|
463
|
+
const probe = spawnSync(py, ['--version'], { stdio: 'ignore' });
|
|
464
|
+
if (probe.status === 0) {
|
|
465
|
+
log(blue(`→ Delegating to the Python wizard (${py} ${initPy})...`));
|
|
466
|
+
const res = spawnSync(py, [initPy], { stdio: 'inherit' });
|
|
467
|
+
return res.status == null ? 1 : res.status;
|
|
468
|
+
}
|
|
469
|
+
}
|
|
470
|
+
log(red('--wizard requested but python3/python is not available on PATH.'));
|
|
471
|
+
log(yellow('Re-run without --wizard to use the pure-Node installer.'));
|
|
472
|
+
return 1;
|
|
473
|
+
}
|
|
474
|
+
|
|
475
|
+
function runInit(opts) {
|
|
476
|
+
if (opts.wizard) {
|
|
477
|
+
return delegateToPython();
|
|
478
|
+
}
|
|
479
|
+
|
|
480
|
+
if (!fs.existsSync(SOURCE_AGENTS_DIR)) {
|
|
481
|
+
log(red(`Error: bundled kit not found at ${SOURCE_AGENTS_DIR}`));
|
|
482
|
+
log(yellow('The gabbe package appears to be incomplete (missing agents/).'));
|
|
483
|
+
return 1;
|
|
484
|
+
}
|
|
485
|
+
|
|
486
|
+
log(blue('='.repeat(60)));
|
|
487
|
+
log(blue('GABBE - Agentic Engineering Kit installer (Node)'));
|
|
488
|
+
log(blue('='.repeat(60)));
|
|
489
|
+
log(`Source kit : ${KIT_ROOT}`);
|
|
490
|
+
log(`Target : ${PROJECT_ROOT}`);
|
|
491
|
+
log('');
|
|
492
|
+
|
|
493
|
+
// --- Copy the kit into the project (agents/ + docs/) ---
|
|
494
|
+
log(yellow('Part 1: Copying kit'));
|
|
495
|
+
const targetAgents = path.join(PROJECT_ROOT, 'agents');
|
|
496
|
+
if (path.resolve(targetAgents) === path.resolve(SOURCE_AGENTS_DIR)) {
|
|
497
|
+
log(` ${blue('→')} Target agents/ is the source; skipping copy.`);
|
|
498
|
+
} else {
|
|
499
|
+
const n = safeCopyTree(SOURCE_AGENTS_DIR, targetAgents);
|
|
500
|
+
log(` ${green('✓')} Copied agents/ (${n} files, user content preserved)`);
|
|
501
|
+
}
|
|
502
|
+
if (fs.existsSync(SOURCE_DOCS_DIR)) {
|
|
503
|
+
const targetDocs = path.join(PROJECT_ROOT, 'docs');
|
|
504
|
+
if (path.resolve(targetDocs) !== path.resolve(SOURCE_DOCS_DIR)) {
|
|
505
|
+
const n = safeCopyTree(SOURCE_DOCS_DIR, targetDocs);
|
|
506
|
+
log(` ${green('✓')} Copied docs/ (${n} files)`);
|
|
507
|
+
}
|
|
508
|
+
}
|
|
509
|
+
|
|
510
|
+
const agentsMdSrc = path.join(targetAgents, 'AGENTS.md');
|
|
511
|
+
const skillsSrc = path.join(targetAgents, 'skills');
|
|
512
|
+
|
|
513
|
+
// --- Universal targets (always emitted) ---
|
|
514
|
+
log('');
|
|
515
|
+
log(yellow('Part 2: Universal wiring'));
|
|
516
|
+
|
|
517
|
+
// Root AGENTS.md (agents.md open standard).
|
|
518
|
+
const rootAgentsMd = path.join(PROJECT_ROOT, 'AGENTS.md');
|
|
519
|
+
if (fs.existsSync(agentsMdSrc)) {
|
|
520
|
+
if (path.resolve(rootAgentsMd) !== path.resolve(agentsMdSrc)) {
|
|
521
|
+
wireAgentsLink(rootAgentsMd, agentsMdSrc);
|
|
522
|
+
log(` ${green('✓')} Wired root AGENTS.md (agents.md standard)`);
|
|
523
|
+
}
|
|
524
|
+
} else {
|
|
525
|
+
log(` ${yellow('!')} agents/AGENTS.md not found; root AGENTS.md not wired.`);
|
|
526
|
+
}
|
|
527
|
+
|
|
528
|
+
// Universal .agents/skills/<slug>/SKILL.md tree.
|
|
529
|
+
if (fs.existsSync(skillsSrc)) {
|
|
530
|
+
const n = emitUniversalSkills(skillsSrc, path.join(PROJECT_ROOT, '.agents', 'skills'));
|
|
531
|
+
log(` ${green('✓')} Emitted ${n} universal skills (.agents/skills/<slug>/SKILL.md)`);
|
|
532
|
+
} else {
|
|
533
|
+
log(` ${yellow('!')} agents/skills not found; universal skills not emitted.`);
|
|
534
|
+
}
|
|
535
|
+
|
|
536
|
+
// --- Per-agent wiring ---
|
|
537
|
+
const agents = resolveAgents(opts.agents);
|
|
538
|
+
if (agents.length) {
|
|
539
|
+
log('');
|
|
540
|
+
log(yellow('Part 3: Per-agent wiring'));
|
|
541
|
+
const ctx = { skillsSrc, agentsMdSrc };
|
|
542
|
+
for (const agent of agents) {
|
|
543
|
+
wireAgent(agent, ctx);
|
|
544
|
+
}
|
|
545
|
+
} else {
|
|
546
|
+
log('');
|
|
547
|
+
log(` ${blue('→')} No --agents specified; only universal targets wired.`);
|
|
548
|
+
log(` ${blue('→')} Re-run with e.g. --agents claude,cursor to wire tools.`);
|
|
549
|
+
}
|
|
550
|
+
|
|
551
|
+
log('');
|
|
552
|
+
log(green('Setup complete.'));
|
|
553
|
+
log(`The kit is installed at: ${targetAgents}`);
|
|
554
|
+
return 0;
|
|
555
|
+
}
|
|
556
|
+
|
|
557
|
+
function main() {
|
|
558
|
+
const opts = parseArgs(process.argv.slice(2));
|
|
559
|
+
if (opts.help) {
|
|
560
|
+
process.stdout.write(USAGE);
|
|
561
|
+
return 0;
|
|
562
|
+
}
|
|
563
|
+
// `init` is the default command.
|
|
564
|
+
if (opts.command === null) opts.command = 'init';
|
|
565
|
+
if (opts.command === 'init') {
|
|
566
|
+
return runInit(opts);
|
|
567
|
+
}
|
|
568
|
+
process.stdout.write(USAGE);
|
|
569
|
+
return 0;
|
|
570
|
+
}
|
|
571
|
+
|
|
572
|
+
process.exit(main());
|