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,120 @@
|
|
|
1
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
import os
|
|
3
|
+
import re
|
|
4
|
+
from pathlib import Path
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def main():
|
|
8
|
+
root_dir = Path(__file__).parent.parent.parent
|
|
9
|
+
skills_dir = root_dir / "agents" / "skills"
|
|
10
|
+
|
|
11
|
+
# Exclude these directories from search
|
|
12
|
+
exclude_dirs = {".git", ".venv", "node_modules", "__pycache__", "gabbe"}
|
|
13
|
+
|
|
14
|
+
# 1. Discover all existing skills
|
|
15
|
+
existing_skills = set()
|
|
16
|
+
if skills_dir.exists():
|
|
17
|
+
for root, dirs, files in os.walk(skills_dir):
|
|
18
|
+
for file in files:
|
|
19
|
+
if file.endswith(".skill.md"):
|
|
20
|
+
existing_skills.add(file.replace(".skill.md", ""))
|
|
21
|
+
|
|
22
|
+
print(f"Found {len(existing_skills)} actual skills in {skills_dir}")
|
|
23
|
+
|
|
24
|
+
# 2. Search for skill mentions in all markdown files
|
|
25
|
+
mentioned_skills = set()
|
|
26
|
+
skill_mentions_map = {} # skill -> set of files
|
|
27
|
+
|
|
28
|
+
# regex matches: "some-skill.skill" or "some-skill.skill.md" or "`some-skill`" in specific contexts
|
|
29
|
+
# Let's extract anything that ends in .skill or .skill.md
|
|
30
|
+
skill_pattern1 = re.compile(r"([\w-]+)\.skill(?!\.md)")
|
|
31
|
+
skill_pattern2 = re.compile(r"([\w-]+)\.skill\.md")
|
|
32
|
+
|
|
33
|
+
# In table cells, sometimes they are just backticked: `spec-writer`
|
|
34
|
+
# We will try to match those as well by looking for anything in backticks in the READMEs that matches existing skills,
|
|
35
|
+
# or just collect all backticked words and see if they look like a skill.
|
|
36
|
+
backtick_pattern = re.compile(r"`([\w-]+)`")
|
|
37
|
+
|
|
38
|
+
for root, dirs, files in os.walk(root_dir):
|
|
39
|
+
# Filter exclusions
|
|
40
|
+
dirs[:] = [d for d in dirs if d not in exclude_dirs and not d.startswith(".")]
|
|
41
|
+
|
|
42
|
+
for file in files:
|
|
43
|
+
if not file.endswith(".md"):
|
|
44
|
+
continue
|
|
45
|
+
|
|
46
|
+
filepath = Path(root) / file
|
|
47
|
+
|
|
48
|
+
try:
|
|
49
|
+
with open(filepath, "r", encoding="utf-8") as f:
|
|
50
|
+
content = f.read()
|
|
51
|
+
|
|
52
|
+
matches1 = skill_pattern1.findall(content)
|
|
53
|
+
matches2 = skill_pattern2.findall(content)
|
|
54
|
+
bmatches = backtick_pattern.findall(content)
|
|
55
|
+
|
|
56
|
+
# We count a backticked word as a skill mention if it's already a known skill or ends with -skill etc. Let's just collect all and filter later.
|
|
57
|
+
all_possible = set(matches1 + matches2)
|
|
58
|
+
for bm in bmatches:
|
|
59
|
+
if bm in existing_skills:
|
|
60
|
+
all_possible.add(bm)
|
|
61
|
+
|
|
62
|
+
for skill in all_possible:
|
|
63
|
+
mentioned_skills.add(skill)
|
|
64
|
+
if skill not in skill_mentions_map:
|
|
65
|
+
skill_mentions_map[skill] = set()
|
|
66
|
+
skill_mentions_map[skill].add(str(filepath.relative_to(root_dir)))
|
|
67
|
+
|
|
68
|
+
except Exception as e:
|
|
69
|
+
print(f"Error reading {filepath}: {e}")
|
|
70
|
+
|
|
71
|
+
# 3. Analyze discrepancy
|
|
72
|
+
missing_skills = mentioned_skills - existing_skills
|
|
73
|
+
unmentioned_skills = existing_skills - mentioned_skills
|
|
74
|
+
|
|
75
|
+
print("\n--- Summary ---")
|
|
76
|
+
print(f"Total mentioned skills: {len(mentioned_skills)}")
|
|
77
|
+
print(f"Total existing skills: {len(existing_skills)}")
|
|
78
|
+
|
|
79
|
+
print("\n[⚠️] Mentioned in docs but missing from agents/skills/:")
|
|
80
|
+
if missing_skills:
|
|
81
|
+
for ms in sorted(missing_skills):
|
|
82
|
+
files_mentioned = ", ".join(skill_mentions_map[ms])
|
|
83
|
+
print(f" - {ms} (Found in: {files_mentioned})")
|
|
84
|
+
else:
|
|
85
|
+
print(" None. All mentioned skills exist.")
|
|
86
|
+
|
|
87
|
+
print("\n[ℹ️] Existing skills NOT mentioned in any parsed docs:")
|
|
88
|
+
# We can refine this to check if they are missing from specific files like QUICK_GUIDE.md or README_FULL.md
|
|
89
|
+
if unmentioned_skills:
|
|
90
|
+
for us in sorted(unmentioned_skills):
|
|
91
|
+
print(f" - {us}")
|
|
92
|
+
else:
|
|
93
|
+
print(" None. All existing skills are mentioned somewhere.")
|
|
94
|
+
|
|
95
|
+
# Specifically check docs/QUICK_GUIDE.md and docs/README_FULL.md
|
|
96
|
+
critical_docs = [
|
|
97
|
+
"docs/QUICK_GUIDE.md",
|
|
98
|
+
"docs/README_FULL.md",
|
|
99
|
+
"README.md",
|
|
100
|
+
"agents/skills/00-index.md",
|
|
101
|
+
]
|
|
102
|
+
|
|
103
|
+
for doc in critical_docs:
|
|
104
|
+
doc_path = root_dir / doc
|
|
105
|
+
if doc_path.exists():
|
|
106
|
+
with open(doc_path, "r", encoding="utf-8") as f:
|
|
107
|
+
content = f.read()
|
|
108
|
+
# Find all skill mentions in this doc
|
|
109
|
+
doc_m1 = skill_pattern1.findall(content)
|
|
110
|
+
doc_m2 = skill_pattern2.findall(content)
|
|
111
|
+
doc_bm = [b for b in backtick_pattern.findall(content) if b in existing_skills]
|
|
112
|
+
doc_skills = set(doc_m1 + doc_m2 + doc_bm)
|
|
113
|
+
|
|
114
|
+
print(
|
|
115
|
+
f"\n[📊] {doc} covers {len(doc_skills)} out of {len(existing_skills)} skills."
|
|
116
|
+
)
|
|
117
|
+
|
|
118
|
+
|
|
119
|
+
if __name__ == "__main__":
|
|
120
|
+
main()
|
|
@@ -0,0 +1,284 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
3
|
+
import argparse
|
|
4
|
+
import json
|
|
5
|
+
import os
|
|
6
|
+
import re
|
|
7
|
+
import shutil
|
|
8
|
+
import sys
|
|
9
|
+
from pathlib import Path
|
|
10
|
+
|
|
11
|
+
# Colors
|
|
12
|
+
GREEN = "\033[0;32m"
|
|
13
|
+
YELLOW = "\033[1;33m"
|
|
14
|
+
BLUE = "\033[0;34m"
|
|
15
|
+
RED = "\033[0;31m"
|
|
16
|
+
NC = "\033[0m"
|
|
17
|
+
|
|
18
|
+
# Schema generation embedded into every emitted artifact so downstream tooling
|
|
19
|
+
# can detect the emitted-format version. Consumers that ignore it are unaffected.
|
|
20
|
+
GABBE_SCHEMA_VERSION = 1
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def safe_slug(raw_name, fallback="skill"):
|
|
24
|
+
"""Sanitize a skill name into a filesystem-safe slug.
|
|
25
|
+
|
|
26
|
+
Prevents path traversal: the slug can never contain a path separator, '..',
|
|
27
|
+
NUL, or escape its target directory. Falls back to `fallback` when the name
|
|
28
|
+
sanitizes to empty.
|
|
29
|
+
"""
|
|
30
|
+
slug = (raw_name or "").lower().strip()
|
|
31
|
+
# Collapse any run of non [a-z0-9] into a single hyphen.
|
|
32
|
+
slug = re.sub(r"[^a-z0-9]+", "-", slug)
|
|
33
|
+
slug = slug.strip("-")
|
|
34
|
+
if not slug or slug in (".", ".."):
|
|
35
|
+
slug = re.sub(r"[^a-z0-9]+", "-", str(fallback).lower()).strip("-") or "skill"
|
|
36
|
+
return slug
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
def inject_schema_version(content):
|
|
40
|
+
"""Insert `gabbe-schema-version: <N>` into a leading YAML frontmatter block.
|
|
41
|
+
|
|
42
|
+
Idempotent: if the key is already present the content is returned unchanged.
|
|
43
|
+
If there is no frontmatter, the content is returned unchanged.
|
|
44
|
+
"""
|
|
45
|
+
if "gabbe-schema-version:" in content:
|
|
46
|
+
return content
|
|
47
|
+
if content.startswith("---"):
|
|
48
|
+
end = content.find("---", 3)
|
|
49
|
+
if end != -1:
|
|
50
|
+
head = content[:3]
|
|
51
|
+
block = content[3:end]
|
|
52
|
+
tail = content[end:]
|
|
53
|
+
return (
|
|
54
|
+
head
|
|
55
|
+
+ block.rstrip("\n")
|
|
56
|
+
+ f"\ngabbe-schema-version: {GABBE_SCHEMA_VERSION}\n"
|
|
57
|
+
+ tail
|
|
58
|
+
)
|
|
59
|
+
return content
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
def ensure_yaml_frontmatter(content, filename):
|
|
63
|
+
"""Ensures content has valid YAML frontmatter using PyYAML. Returns (frontmatter_dict, content)."""
|
|
64
|
+
try:
|
|
65
|
+
import yaml
|
|
66
|
+
|
|
67
|
+
if content.startswith("---"):
|
|
68
|
+
end_yaml = content.find("---", 3)
|
|
69
|
+
if end_yaml != -1:
|
|
70
|
+
yaml_text = content[3:end_yaml]
|
|
71
|
+
data = yaml.safe_load(yaml_text)
|
|
72
|
+
if isinstance(data, dict):
|
|
73
|
+
return data, content
|
|
74
|
+
except ImportError:
|
|
75
|
+
# Fallback to simple parser if PyYAML is missing
|
|
76
|
+
if content.startswith("---"):
|
|
77
|
+
end_yaml = content.find("---", 3)
|
|
78
|
+
if end_yaml != -1:
|
|
79
|
+
yaml_text = content[3:end_yaml]
|
|
80
|
+
data = {}
|
|
81
|
+
for line in yaml_text.strip().split("\n"):
|
|
82
|
+
if ":" in line:
|
|
83
|
+
k, v = line.split(":", 1)
|
|
84
|
+
data[k.strip()] = v.strip().strip("\"'")
|
|
85
|
+
return data, content
|
|
86
|
+
except Exception:
|
|
87
|
+
# print(f"Warning: Failed to parse YAML for {filename}: {e}")
|
|
88
|
+
pass
|
|
89
|
+
|
|
90
|
+
# Default frontmatter if missing or failed
|
|
91
|
+
name = filename.replace(".skill.md", "").replace(".md", "").replace(".mdc", "")
|
|
92
|
+
frontmatter = f"""---
|
|
93
|
+
name: {name}
|
|
94
|
+
description: AI Skill for {name}
|
|
95
|
+
version: 1.0
|
|
96
|
+
author: GABBE-Kit
|
|
97
|
+
---
|
|
98
|
+
"""
|
|
99
|
+
return {"name": name}, frontmatter + content
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
def create_symlink(source, target, project_root):
|
|
103
|
+
"""Creates a symlink from target to source, backing up if exists."""
|
|
104
|
+
if target.is_symlink():
|
|
105
|
+
target.unlink()
|
|
106
|
+
elif target.exists():
|
|
107
|
+
# Append ".bak" to the FULL name (with_suffix would drop a real
|
|
108
|
+
# extension, e.g. config.json -> config.bak).
|
|
109
|
+
backup = target.parent / (target.name + ".bak")
|
|
110
|
+
if target.is_dir():
|
|
111
|
+
print(f" {YELLOW}! Backing up existing directory {target.name} to {backup.name}{NC}")
|
|
112
|
+
shutil.move(str(target), str(backup))
|
|
113
|
+
else:
|
|
114
|
+
print(f" {YELLOW}! Backing up existing file {target.name} to {backup.name}{NC}")
|
|
115
|
+
target.rename(backup)
|
|
116
|
+
|
|
117
|
+
# Ensure parent dir exists
|
|
118
|
+
target.parent.mkdir(parents=True, exist_ok=True)
|
|
119
|
+
|
|
120
|
+
# Calculate relative path if possible, else absolute
|
|
121
|
+
try:
|
|
122
|
+
if str(project_root) in str(source.absolute()):
|
|
123
|
+
link_path = os.path.relpath(source, target.parent)
|
|
124
|
+
else:
|
|
125
|
+
link_path = source.absolute()
|
|
126
|
+
|
|
127
|
+
os.symlink(link_path, target)
|
|
128
|
+
# print(f" {GREEN}✓ Linked {target.name} -> {link_path}{NC}")
|
|
129
|
+
except OSError as e:
|
|
130
|
+
# Fallback for Windows (no admin rights) or restricted environments
|
|
131
|
+
print(f" {YELLOW}! Symlink failed ({e}), falling back to copy...{NC}")
|
|
132
|
+
try:
|
|
133
|
+
if source.is_dir():
|
|
134
|
+
if target.exists():
|
|
135
|
+
shutil.rmtree(target)
|
|
136
|
+
shutil.copytree(source, target)
|
|
137
|
+
else:
|
|
138
|
+
if target.exists():
|
|
139
|
+
target.unlink()
|
|
140
|
+
shutil.copy2(source, target)
|
|
141
|
+
print(f" {GREEN}✓ Copied {target.name} (Symlink fallback){NC}")
|
|
142
|
+
except Exception as e2:
|
|
143
|
+
print(f" {RED}x Failed to copy {target}: {e2}{NC}")
|
|
144
|
+
except Exception as e:
|
|
145
|
+
print(f" {RED}x Failed to link {target}: {e}{NC}")
|
|
146
|
+
|
|
147
|
+
|
|
148
|
+
def setup_skills_for_platform(
|
|
149
|
+
platform, skills_src_dir, target_dir, project_root, native_subset=None
|
|
150
|
+
):
|
|
151
|
+
"""
|
|
152
|
+
Distributes skills to platform-specific formats.
|
|
153
|
+
|
|
154
|
+
native_subset: when "core", emit only skills flagged `core: true` in their
|
|
155
|
+
frontmatter. This keeps a large collection (180+ skills) under a runtime's
|
|
156
|
+
native skill-discovery budget (e.g. Claude Code truncates big skill menus) —
|
|
157
|
+
the full catalog stays discoverable via agents/skills/00-index.md. Default
|
|
158
|
+
(None) emits every skill, preserving existing behavior.
|
|
159
|
+
"""
|
|
160
|
+
print(f"\n{BLUE}→ Setting up skills for {platform}...{NC}")
|
|
161
|
+
target_dir.mkdir(parents=True, exist_ok=True)
|
|
162
|
+
|
|
163
|
+
# Get all .skill.md files recursively
|
|
164
|
+
skill_files = list(skills_src_dir.rglob("*.skill.md"))
|
|
165
|
+
|
|
166
|
+
count = 0
|
|
167
|
+
for skill_file in skill_files:
|
|
168
|
+
content = skill_file.read_text()
|
|
169
|
+
meta, content_with_fm = ensure_yaml_frontmatter(content, skill_file.name)
|
|
170
|
+
|
|
171
|
+
# Curated native emit: skip non-core skills when a subset was requested.
|
|
172
|
+
if native_subset == "core" and str(meta.get("core", "")).lower() != "true":
|
|
173
|
+
continue
|
|
174
|
+
|
|
175
|
+
# Slugify name for files/commands (e.g. "Agent Interop" -> "agent-interop").
|
|
176
|
+
# safe_slug() prevents path traversal via a malicious frontmatter name.
|
|
177
|
+
raw_name = meta.get("name", skill_file.stem.replace(".skill", ""))
|
|
178
|
+
skill_slug = safe_slug(raw_name, fallback=skill_file.stem.replace(".skill", ""))
|
|
179
|
+
skill_desc = meta.get("description", f"Skill for {raw_name}")
|
|
180
|
+
|
|
181
|
+
if platform == "Cursor":
|
|
182
|
+
# Flatten structure: .cursor/rules/<slug>.mdc
|
|
183
|
+
dest_file = target_dir / f"{skill_slug}.mdc"
|
|
184
|
+
|
|
185
|
+
# Cursor "Agent Requested" rule: description + alwaysApply:false and
|
|
186
|
+
# NO globs, so Cursor selects the rule intelligently by description
|
|
187
|
+
# rather than auto-attaching it to every file (per docs.cursor.com).
|
|
188
|
+
cursor_fm = (
|
|
189
|
+
"---\n"
|
|
190
|
+
f"description: {skill_desc}\n"
|
|
191
|
+
"alwaysApply: false\n"
|
|
192
|
+
f"gabbe-schema-version: {GABBE_SCHEMA_VERSION}\n"
|
|
193
|
+
"---\n"
|
|
194
|
+
)
|
|
195
|
+
# Strip existing FM and prepend Cursor FM
|
|
196
|
+
start_body = content_with_fm.find("---", 3) + 3
|
|
197
|
+
body = content_with_fm[start_body:].strip()
|
|
198
|
+
|
|
199
|
+
final_content = cursor_fm + "\n" + body
|
|
200
|
+
dest_file.write_text(final_content)
|
|
201
|
+
count += 1
|
|
202
|
+
|
|
203
|
+
elif platform in (
|
|
204
|
+
"VS Code",
|
|
205
|
+
"GitHub Copilot",
|
|
206
|
+
"Claude Code",
|
|
207
|
+
"Antigravity",
|
|
208
|
+
"OpenCode",
|
|
209
|
+
"Universal",
|
|
210
|
+
):
|
|
211
|
+
# Agent-skills open standard (agentskills.io), shared by Copilot,
|
|
212
|
+
# VS Code, Claude Code, Antigravity (.agents/skills), OpenCode, and the
|
|
213
|
+
# universal .agents/skills tree: <target>/<slug>/SKILL.md as a real file
|
|
214
|
+
# (not a symlink) with name+description frontmatter so the skill is
|
|
215
|
+
# discoverable on every platform and portable across filesystems.
|
|
216
|
+
skill_folder = target_dir / skill_slug
|
|
217
|
+
skill_folder.mkdir(parents=True, exist_ok=True)
|
|
218
|
+
(skill_folder / "SKILL.md").write_text(inject_schema_version(content_with_fm))
|
|
219
|
+
|
|
220
|
+
if platform in ("VS Code", "GitHub Copilot"):
|
|
221
|
+
# Optional GABBE metadata (ignored by Copilot; kept for tooling).
|
|
222
|
+
config = {
|
|
223
|
+
"name": skill_slug,
|
|
224
|
+
"description": skill_desc,
|
|
225
|
+
"version": "1.0.0",
|
|
226
|
+
"gabbe-schema-version": GABBE_SCHEMA_VERSION,
|
|
227
|
+
"slashCommands": [{"name": skill_slug, "description": skill_desc}],
|
|
228
|
+
}
|
|
229
|
+
(skill_folder / "config.json").write_text(json.dumps(config, indent=2))
|
|
230
|
+
count += 1
|
|
231
|
+
|
|
232
|
+
print(f" {GREEN}✓ Processed {count} skills for {platform}{NC}")
|
|
233
|
+
|
|
234
|
+
|
|
235
|
+
def main():
|
|
236
|
+
parser = argparse.ArgumentParser(description="Compile skills for specific platforms.")
|
|
237
|
+
parser.add_argument(
|
|
238
|
+
"--platform",
|
|
239
|
+
required=True,
|
|
240
|
+
choices=[
|
|
241
|
+
"Cursor",
|
|
242
|
+
"VS Code",
|
|
243
|
+
"GitHub Copilot",
|
|
244
|
+
"Claude Code",
|
|
245
|
+
"Antigravity",
|
|
246
|
+
"OpenCode",
|
|
247
|
+
"Universal",
|
|
248
|
+
"All",
|
|
249
|
+
],
|
|
250
|
+
help="Target platform",
|
|
251
|
+
)
|
|
252
|
+
parser.add_argument(
|
|
253
|
+
"--skills-dir", required=True, help="Source directory for skills (agents/skills)"
|
|
254
|
+
)
|
|
255
|
+
parser.add_argument("--target-dir", required=True, help="Target directory for output")
|
|
256
|
+
parser.add_argument("--project-root", required=True, help="Root of the project")
|
|
257
|
+
parser.add_argument(
|
|
258
|
+
"--native-subset",
|
|
259
|
+
choices=["all", "core"],
|
|
260
|
+
default="all",
|
|
261
|
+
help="'core' emits only skills flagged core:true (fits native discovery budgets); "
|
|
262
|
+
"default 'all' emits every skill. Full catalog is always in skills/00-index.md.",
|
|
263
|
+
)
|
|
264
|
+
|
|
265
|
+
args = parser.parse_args()
|
|
266
|
+
|
|
267
|
+
skills_src = Path(args.skills_dir)
|
|
268
|
+
target_dir = Path(args.target_dir)
|
|
269
|
+
project_root = Path(args.project_root)
|
|
270
|
+
|
|
271
|
+
if not skills_src.exists():
|
|
272
|
+
print(f"{RED}Error: Skills directory not found at {skills_src}{NC}")
|
|
273
|
+
sys.exit(1)
|
|
274
|
+
|
|
275
|
+
subset = None if args.native_subset == "all" else args.native_subset
|
|
276
|
+
if args.platform == "All":
|
|
277
|
+
# Example logic for 'All' if needed, otherwise distinct calls are safer
|
|
278
|
+
pass
|
|
279
|
+
else:
|
|
280
|
+
setup_skills_for_platform(args.platform, skills_src, target_dir, project_root, subset)
|
|
281
|
+
|
|
282
|
+
|
|
283
|
+
if __name__ == "__main__":
|
|
284
|
+
main()
|
|
@@ -0,0 +1,187 @@
|
|
|
1
|
+
# SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
import os
|
|
3
|
+
import re
|
|
4
|
+
from pathlib import Path
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def main():
|
|
8
|
+
# Use path relative to this script location to find project root reliability
|
|
9
|
+
script_dir = Path(__file__).parent.resolve()
|
|
10
|
+
# script is in agents/scripts, so root is 2 levels up
|
|
11
|
+
root_dir = script_dir.parent.parent
|
|
12
|
+
agents_dir = root_dir / "agents"
|
|
13
|
+
|
|
14
|
+
# Exclude these directories
|
|
15
|
+
exclude_dirs = {".git", ".venv", "node_modules", "__pycache__", "gabbe"}
|
|
16
|
+
|
|
17
|
+
# 1. Discover all existing components
|
|
18
|
+
existing = {"skills": set(), "templates": set(), "guides": set(), "personas": set()}
|
|
19
|
+
|
|
20
|
+
folders = {
|
|
21
|
+
"skills": agents_dir / "skills",
|
|
22
|
+
"templates": agents_dir / "templates",
|
|
23
|
+
"guides": agents_dir / "guides",
|
|
24
|
+
"personas": agents_dir / "personas",
|
|
25
|
+
"memory": agents_dir / "memory",
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
# Gather skills (*.skill.md)
|
|
29
|
+
if folders["skills"].exists():
|
|
30
|
+
for root, _, files in os.walk(folders["skills"]):
|
|
31
|
+
for f in files:
|
|
32
|
+
if f.endswith(".skill.md"):
|
|
33
|
+
existing["skills"].add(f.replace(".skill.md", ""))
|
|
34
|
+
|
|
35
|
+
# Gather templates (*_TEMPLATE.md)
|
|
36
|
+
template_folders = [folders["templates"], folders["memory"]]
|
|
37
|
+
for tf in template_folders:
|
|
38
|
+
if tf.exists():
|
|
39
|
+
for root, _, files in os.walk(tf):
|
|
40
|
+
for f in files:
|
|
41
|
+
if f.endswith(".md") and "TEMPLATE" in f:
|
|
42
|
+
existing["templates"].add(f.replace(".md", ""))
|
|
43
|
+
|
|
44
|
+
# Gather guides (*.md in guides folder)
|
|
45
|
+
if folders["guides"].exists():
|
|
46
|
+
for root, _, files in os.walk(folders["guides"]):
|
|
47
|
+
for f in files:
|
|
48
|
+
if f.endswith(".md") and f != "00-index.md":
|
|
49
|
+
existing["guides"].add(f.replace(".md", ""))
|
|
50
|
+
|
|
51
|
+
# Gather personas (*.md in personas folder)
|
|
52
|
+
if folders["personas"].exists():
|
|
53
|
+
for root, _, files in os.walk(folders["personas"]):
|
|
54
|
+
for f in files:
|
|
55
|
+
if f.endswith(".md") and f != "00-index.md":
|
|
56
|
+
existing["personas"].add(f.replace(".md", ""))
|
|
57
|
+
|
|
58
|
+
print(
|
|
59
|
+
f"Discovered {len(existing['skills'])} skills, {len(existing['templates'])} templates, {len(existing['guides'])} guides, {len(existing['personas'])} personas.\n"
|
|
60
|
+
)
|
|
61
|
+
|
|
62
|
+
# 2. Search for mentions in root and docs/
|
|
63
|
+
mentioned = {"skills": set(), "templates": set(), "guides": set(), "personas": set()}
|
|
64
|
+
|
|
65
|
+
# Patterns
|
|
66
|
+
skill_p1 = re.compile(r"([\w-]+)\.skill(?!\.md)")
|
|
67
|
+
skill_p2 = re.compile(r"([\w-]+)\.skill\.md")
|
|
68
|
+
template_p = re.compile(r"([\w_]+_TEMPLATE)\.md")
|
|
69
|
+
guide_p = re.compile(r"guides/([\w-]+)\.md")
|
|
70
|
+
|
|
71
|
+
# We will also just check if the exact filename (minus extension) appears in the docs
|
|
72
|
+
def check_exact_match(content, item_set, item_type):
|
|
73
|
+
for item in item_set:
|
|
74
|
+
# simple string match
|
|
75
|
+
if item in content:
|
|
76
|
+
mentioned[item_type].add(item)
|
|
77
|
+
|
|
78
|
+
docs_to_check = []
|
|
79
|
+
for root, dirs, files in os.walk(root_dir):
|
|
80
|
+
dirs[:] = [d for d in dirs if d not in exclude_dirs and not d.startswith(".")]
|
|
81
|
+
for file in files:
|
|
82
|
+
if file.endswith(".md"):
|
|
83
|
+
docs_to_check.append(Path(root) / file)
|
|
84
|
+
|
|
85
|
+
for filepath in docs_to_check:
|
|
86
|
+
try:
|
|
87
|
+
with open(filepath, "r", encoding="utf-8") as f:
|
|
88
|
+
content = f.read()
|
|
89
|
+
|
|
90
|
+
# Extract via regex
|
|
91
|
+
mentioned["skills"].update(skill_p1.findall(content))
|
|
92
|
+
mentioned["skills"].update(skill_p2.findall(content))
|
|
93
|
+
mentioned["templates"].update(template_p.findall(content))
|
|
94
|
+
mentioned["guides"].update(guide_p.findall(content))
|
|
95
|
+
|
|
96
|
+
# Check exact mentions for all
|
|
97
|
+
check_exact_match(content, existing["skills"], "skills")
|
|
98
|
+
check_exact_match(content, existing["templates"], "templates")
|
|
99
|
+
check_exact_match(content, existing["guides"], "guides")
|
|
100
|
+
check_exact_match(content, existing["personas"], "personas")
|
|
101
|
+
|
|
102
|
+
except Exception as e:
|
|
103
|
+
print(f"Error reading {filepath}: {e}")
|
|
104
|
+
|
|
105
|
+
# 3. Analyze differences
|
|
106
|
+
for category in existing.keys():
|
|
107
|
+
missing = mentioned[category] - existing[category]
|
|
108
|
+
unmentioned = existing[category] - mentioned[category]
|
|
109
|
+
|
|
110
|
+
# Filter expected placeholders
|
|
111
|
+
if category == "skills":
|
|
112
|
+
missing -= {"my-language", "your-skill-name"}
|
|
113
|
+
elif category == "templates":
|
|
114
|
+
missing -= {"YOUR_TEMPLATE"}
|
|
115
|
+
|
|
116
|
+
print(f"--- {category.upper()} ---")
|
|
117
|
+
print(f"Total mentioned: {len(mentioned[category])}")
|
|
118
|
+
print(f"Total existing: {len(existing[category])}")
|
|
119
|
+
|
|
120
|
+
if missing:
|
|
121
|
+
print("[⚠️] Mentioned in docs but missing from files:")
|
|
122
|
+
for m in sorted(missing):
|
|
123
|
+
print(f" - {m}")
|
|
124
|
+
else:
|
|
125
|
+
print(f"[✅] All mentioned {category} exist.")
|
|
126
|
+
|
|
127
|
+
if unmentioned:
|
|
128
|
+
print(f"[ℹ️] Existing {category} NOT explicitly mentioned in any parsed docs:")
|
|
129
|
+
for u in sorted(unmentioned):
|
|
130
|
+
print(f" - {u}")
|
|
131
|
+
else:
|
|
132
|
+
print(f"[✅] All existing {category} are mentioned somewhere in docs.")
|
|
133
|
+
|
|
134
|
+
print()
|
|
135
|
+
|
|
136
|
+
# 4. Critical Quality Checks
|
|
137
|
+
print("--- CRITICAL QUALITY CHECKS ---")
|
|
138
|
+
outdated_version_files = []
|
|
139
|
+
corrupted_header_files = []
|
|
140
|
+
|
|
141
|
+
for filepath in docs_to_check:
|
|
142
|
+
try:
|
|
143
|
+
with open(filepath, "r", encoding="utf-8") as f:
|
|
144
|
+
content = f.read()
|
|
145
|
+
|
|
146
|
+
if "0.2.0" in content:
|
|
147
|
+
outdated_version_files.append(str(filepath))
|
|
148
|
+
|
|
149
|
+
if "## 🚀- **" in content:
|
|
150
|
+
corrupted_header_files.append(str(filepath))
|
|
151
|
+
|
|
152
|
+
except Exception:
|
|
153
|
+
pass
|
|
154
|
+
|
|
155
|
+
if outdated_version_files:
|
|
156
|
+
print("[❌] Outdated CLI version (0.2.0) found in:")
|
|
157
|
+
for f in outdated_version_files:
|
|
158
|
+
print(f" - {f}")
|
|
159
|
+
else:
|
|
160
|
+
print("[✅] No outdated CLI versions found.")
|
|
161
|
+
|
|
162
|
+
if corrupted_header_files:
|
|
163
|
+
print("[❌] Corrupted headers found in:")
|
|
164
|
+
for f in corrupted_header_files:
|
|
165
|
+
print(f" - {f}")
|
|
166
|
+
else:
|
|
167
|
+
print("[✅] No corrupted headers found.")
|
|
168
|
+
|
|
169
|
+
# 5. Workflow Disovery
|
|
170
|
+
print("\n--- WORKFLOWS ---")
|
|
171
|
+
workflows = set()
|
|
172
|
+
workflow_paths = [root_dir / "agents/workflows", root_dir / ".agent/workflows"]
|
|
173
|
+
for wp in workflow_paths:
|
|
174
|
+
if wp.exists():
|
|
175
|
+
for f in wp.glob("*.md"):
|
|
176
|
+
workflows.add(f.name)
|
|
177
|
+
|
|
178
|
+
if workflows:
|
|
179
|
+
print(f"Found {len(workflows)} workflows:")
|
|
180
|
+
for w in sorted(workflows):
|
|
181
|
+
print(f" - {w}")
|
|
182
|
+
else:
|
|
183
|
+
print("[ℹ️] No workflows found.")
|
|
184
|
+
|
|
185
|
+
|
|
186
|
+
if __name__ == "__main__":
|
|
187
|
+
main()
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
#!/bin/bash
|
|
2
|
+
# setup-context.sh: Dumps project context for AI Agents
|
|
3
|
+
|
|
4
|
+
echo "# Project Context Report"
|
|
5
|
+
echo "Generated: $(date)"
|
|
6
|
+
echo ""
|
|
7
|
+
|
|
8
|
+
echo "## Directory Structure"
|
|
9
|
+
echo '```'
|
|
10
|
+
# Use git ls-files if available, otherwise find, excluding node_modules/vendor/etc
|
|
11
|
+
if [ -d .git ]; then
|
|
12
|
+
git ls-files --exclude-standard -co | grep -vE "^(\.git|\.idea|\.vscode|node_modules|vendor|dist|build|coverage)" | tree --fromfile -L 3
|
|
13
|
+
else
|
|
14
|
+
find . -maxdepth 3 -not -path '*/.*' -not -path './node_modules*' -not -path './vendor*' -not -path './dist*' -print | sort | sed 's/[^/]*\// /g'
|
|
15
|
+
fi
|
|
16
|
+
echo '```'
|
|
17
|
+
echo ""
|
|
18
|
+
|
|
19
|
+
echo "## Key Configuration Files"
|
|
20
|
+
FILES=("package.json" "composer.json" "pyproject.toml" "go.mod" "Cargo.toml" "Makefile" "Dockerfile" "docker-compose.yml" ".env.example" "agents.md" "AGENTS.md" "SETUP_MISSION.md" "BOOTSTRAP_MISSION.md")
|
|
21
|
+
|
|
22
|
+
for f in "${FILES[@]}"; do
|
|
23
|
+
if [ -f "$f" ]; then
|
|
24
|
+
echo "### $f"
|
|
25
|
+
echo '```'${f##*.}
|
|
26
|
+
cat "$f"
|
|
27
|
+
echo '```'
|
|
28
|
+
echo ""
|
|
29
|
+
fi
|
|
30
|
+
done
|
|
31
|
+
|
|
32
|
+
echo "## Active Task List"
|
|
33
|
+
if [ -f "task.md" ]; then
|
|
34
|
+
echo '```markdown'
|
|
35
|
+
cat "task.md"
|
|
36
|
+
echo '```'
|
|
37
|
+
fi
|