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,250 @@
|
|
|
1
|
+
<#
|
|
2
|
+
.SYNOPSIS
|
|
3
|
+
GABBE Agentic Kit - Context Setup Script (PowerShell)
|
|
4
|
+
.DESCRIPTION
|
|
5
|
+
Wires up the agents/ directory to various AI coding tools on Windows.
|
|
6
|
+
Creates necessary symlinks (or copies if non-admin) and initializes memory.
|
|
7
|
+
.NOTES
|
|
8
|
+
Usage: .\setup-context.ps1
|
|
9
|
+
#>
|
|
10
|
+
|
|
11
|
+
$ErrorActionPreference = "Stop"
|
|
12
|
+
|
|
13
|
+
# --- Configuration ---
|
|
14
|
+
$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
|
|
15
|
+
$AgentsDir = Resolve-Path "$ScriptDir\.."
|
|
16
|
+
$ProjectRoot = Resolve-Path "$AgentsDir\.."
|
|
17
|
+
|
|
18
|
+
# Colors for Output
|
|
19
|
+
function Write-Green($text) { Write-Host $text -ForegroundColor Green }
|
|
20
|
+
function Write-Yellow($text) { Write-Host $text -ForegroundColor Yellow }
|
|
21
|
+
function Write-Blue($text) { Write-Host $text -ForegroundColor Cyan }
|
|
22
|
+
function Write-Red($text) { Write-Host $text -ForegroundColor Red }
|
|
23
|
+
|
|
24
|
+
# Helper: Create Symlink with Fallback
|
|
25
|
+
function New-SymlinkOrCopy {
|
|
26
|
+
param (
|
|
27
|
+
[string]$SourcePath,
|
|
28
|
+
[string]$TargetPath,
|
|
29
|
+
[bool]$IsDirectory = $false
|
|
30
|
+
)
|
|
31
|
+
|
|
32
|
+
$Source = $SourcePath
|
|
33
|
+
$Target = $TargetPath
|
|
34
|
+
|
|
35
|
+
# Remove existing target if it exists
|
|
36
|
+
if (Test-Path $Target) {
|
|
37
|
+
if ((Get-Item $Target).LinkType -in @('SymbolicLink', 'Junction', 'HardLink')) {
|
|
38
|
+
# It's a link (symlink/junction/hardlink) — safe to remove the link itself.
|
|
39
|
+
# LinkType avoids misclassifying a regular file/dir as a link (which would
|
|
40
|
+
# delete the user's real file); a directory Junction must be in this set or
|
|
41
|
+
# it falls into the "real dir" branch and Move-Item would relocate its target.
|
|
42
|
+
Remove-Item $Target -Force -Recurse -ErrorAction SilentlyContinue
|
|
43
|
+
} else {
|
|
44
|
+
# It's a real file/dir, backup first
|
|
45
|
+
Write-Yellow "! Backing up existing $Target to $Target.bak"
|
|
46
|
+
Move-Item $Target "$Target.bak" -Force
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
# Ensure parent dir exists
|
|
51
|
+
$ParentDir = Split-Path $Target -Parent
|
|
52
|
+
if (-not (Test-Path $ParentDir)) {
|
|
53
|
+
New-Item -ItemType Directory -Path $ParentDir -Force | Out-Null
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
try {
|
|
57
|
+
# Try Creating Symlink (Requires Admin usually, or Dev Mode)
|
|
58
|
+
New-Item -ItemType SymbolicLink -Path $Target -Target $Source -Force | Out-Null
|
|
59
|
+
Write-Green "✓ Linked $(Split-Path $Target -Leaf) -> $Source"
|
|
60
|
+
}
|
|
61
|
+
catch {
|
|
62
|
+
Write-Yellow "! Symlink failed (requires Admin or Dev Mode). Falling back to Copy..."
|
|
63
|
+
try {
|
|
64
|
+
if ($IsDirectory) {
|
|
65
|
+
Copy-Item -Path $Source -Destination $Target -Recurse -Force
|
|
66
|
+
} else {
|
|
67
|
+
Copy-Item -Path $Source -Destination $Target -Force
|
|
68
|
+
}
|
|
69
|
+
Write-Green "✓ Copied $(Split-Path $Target -Leaf) (Fallback)"
|
|
70
|
+
}
|
|
71
|
+
catch {
|
|
72
|
+
Write-Red "x Failed to copy: $_"
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
Write-Host ""
|
|
78
|
+
Write-Blue "======================================"
|
|
79
|
+
Write-Blue " Agentic Engineering Kit — Setup "
|
|
80
|
+
Write-Blue "======================================"
|
|
81
|
+
Write-Host ""
|
|
82
|
+
|
|
83
|
+
# -----------------------------------------------------------------------------
|
|
84
|
+
# Step 1: Unifying Context (AGENTS.md -> Tools)
|
|
85
|
+
# -----------------------------------------------------------------------------
|
|
86
|
+
Write-Yellow "Step 1: Unifying agent context (AGENTS.md -> all tools)"
|
|
87
|
+
|
|
88
|
+
# Paths
|
|
89
|
+
$AgentsMd = "$AgentsDir\AGENTS.md"
|
|
90
|
+
|
|
91
|
+
# Claude
|
|
92
|
+
New-SymlinkOrCopy -SourcePath $AgentsMd -TargetPath "$ProjectRoot\.claude\CLAUDE.md"
|
|
93
|
+
|
|
94
|
+
# Cursor
|
|
95
|
+
New-SymlinkOrCopy -SourcePath $AgentsMd -TargetPath "$ProjectRoot\.cursorrules"
|
|
96
|
+
|
|
97
|
+
# Gemini / Antigravity
|
|
98
|
+
if (-not (Test-Path "$ProjectRoot\.gemini")) { New-Item -ItemType Directory -Path "$ProjectRoot\.gemini" | Out-Null }
|
|
99
|
+
if (-not (Test-Path "$ProjectRoot\.gemini\settings.json")) {
|
|
100
|
+
$SettingsJson = @{
|
|
101
|
+
agent_instructions_file = "..\agents\AGENTS.md"
|
|
102
|
+
skills_directory = "..\agents\skills\"
|
|
103
|
+
notes = "Managed by agents\setup-context.ps1"
|
|
104
|
+
} | ConvertTo-Json -Depth 2
|
|
105
|
+
Set-Content -Path "$ProjectRoot\.gemini\settings.json" -Value $SettingsJson
|
|
106
|
+
Write-Green "✓ .gemini\settings.json created"
|
|
107
|
+
} else {
|
|
108
|
+
Write-Yellow "! .gemini\settings.json already exists (skipped)"
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
# GitHub Copilot
|
|
112
|
+
New-SymlinkOrCopy -SourcePath $AgentsMd -TargetPath "$ProjectRoot\.github\copilot-instructions.md"
|
|
113
|
+
|
|
114
|
+
Write-Host ""
|
|
115
|
+
|
|
116
|
+
# -----------------------------------------------------------------------------
|
|
117
|
+
# Step 2: Wiring Skills
|
|
118
|
+
# -----------------------------------------------------------------------------
|
|
119
|
+
Write-Yellow "Step 2: Wiring skills directories"
|
|
120
|
+
|
|
121
|
+
$SkillsDir = "$AgentsDir\skills"
|
|
122
|
+
|
|
123
|
+
# Claude Skills
|
|
124
|
+
New-SymlinkOrCopy -SourcePath $SkillsDir -TargetPath "$ProjectRoot\.claude\skills" -IsDirectory $true
|
|
125
|
+
|
|
126
|
+
# Agent Skills (Gemini)
|
|
127
|
+
New-SymlinkOrCopy -SourcePath $SkillsDir -TargetPath "$ProjectRoot\.agent\skills" -IsDirectory $true
|
|
128
|
+
|
|
129
|
+
# Cursor & VS Code (Compile)
|
|
130
|
+
$CompileScript = "$AgentsDir\scripts\compile_skills.py"
|
|
131
|
+
if (Test-Path $CompileScript) {
|
|
132
|
+
Write-Yellow "Compiling skills for Cursor and VS Code..."
|
|
133
|
+
|
|
134
|
+
# Check for Python
|
|
135
|
+
try {
|
|
136
|
+
python --version | Out-Null
|
|
137
|
+
|
|
138
|
+
# Cursor
|
|
139
|
+
python "$CompileScript" --platform "Cursor" --skills-dir "$SkillsDir" --target-dir "$ProjectRoot\.cursor\rules" --project-root "$ProjectRoot"
|
|
140
|
+
|
|
141
|
+
# VS Code
|
|
142
|
+
python "$CompileScript" --platform "VS Code" --skills-dir "$SkillsDir" --target-dir "$ProjectRoot\.github\skills" --project-root "$ProjectRoot"
|
|
143
|
+
}
|
|
144
|
+
catch {
|
|
145
|
+
Write-Red "x Python not found or error running compile_skills.py. Skipping compilation."
|
|
146
|
+
}
|
|
147
|
+
} else {
|
|
148
|
+
Write-Red "x compile_skills.py not found at $CompileScript"
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
Write-Host ""
|
|
152
|
+
|
|
153
|
+
# -----------------------------------------------------------------------------
|
|
154
|
+
# Step 3: Initialize Memory
|
|
155
|
+
# -----------------------------------------------------------------------------
|
|
156
|
+
Write-Yellow "Step 3: Initializing loki\memory structure"
|
|
157
|
+
|
|
158
|
+
$MemoryDir = "$AgentsDir\memory"
|
|
159
|
+
New-Item -ItemType Directory -Path "$MemoryDir\episodic\SESSION_SNAPSHOT" -Force | Out-Null
|
|
160
|
+
New-Item -ItemType Directory -Path "$MemoryDir\semantic" -Force | Out-Null
|
|
161
|
+
Write-Green "✓ loki\memory structure created"
|
|
162
|
+
|
|
163
|
+
Write-Host ""
|
|
164
|
+
|
|
165
|
+
# -----------------------------------------------------------------------------
|
|
166
|
+
# Step 4: Initialize Memory Files
|
|
167
|
+
# -----------------------------------------------------------------------------
|
|
168
|
+
Write-Yellow "Step 4: Initializing memory files"
|
|
169
|
+
|
|
170
|
+
# We use the existing logic to check if they exist, but creating them in PS is verbose.
|
|
171
|
+
# Ideally these should be templates copied from agents\templates\ if possible,
|
|
172
|
+
# or we just write short placeholders like the bash script.
|
|
173
|
+
|
|
174
|
+
function Create-MemoryFile($FileName, $Content) {
|
|
175
|
+
$Path = "$MemoryDir\$FileName"
|
|
176
|
+
if (-not (Test-Path $Path)) {
|
|
177
|
+
Set-Content -Path $Path -Value $Content -Encoding UTF8
|
|
178
|
+
Write-Green "✓ Created $FileName"
|
|
179
|
+
} else {
|
|
180
|
+
Write-Yellow "! $FileName already exists (skipped)"
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
$ProjectStateContent = @"
|
|
185
|
+
# PROJECT_STATE.md — Master Project State
|
|
186
|
+
> Updated by: sdlc-checkpoint.skill
|
|
187
|
+
|
|
188
|
+
## Current SDLC Phase
|
|
189
|
+
Phase: S00_INITIALIZED
|
|
190
|
+
Status: NOT_STARTED
|
|
191
|
+
|
|
192
|
+
## Next Actions
|
|
193
|
+
1. Fill in AGENTS.md
|
|
194
|
+
2. Run spec-writer.skill
|
|
195
|
+
"@
|
|
196
|
+
|
|
197
|
+
Create-MemoryFile "PROJECT_STATE.md" $ProjectStateContent
|
|
198
|
+
|
|
199
|
+
$AuditLogContent = @"
|
|
200
|
+
# AUDIT_LOG.md — Project Audit Trail
|
|
201
|
+
> APPEND ONLY. Updated by: audit-trail.skill
|
|
202
|
+
|
|
203
|
+
| Timestamp | Session | Agent/Human | Action Type | Description | Outcome |
|
|
204
|
+
|---|---|---|---|---|---|
|
|
205
|
+
| INIT | S00 | setup-context.ps1 | PHASE_TRANSITION | Kit initialized | SUCCESS |
|
|
206
|
+
"@
|
|
207
|
+
|
|
208
|
+
Create-MemoryFile "AUDIT_LOG.md" $AuditLogContent
|
|
209
|
+
|
|
210
|
+
$ContinuityContent = @"
|
|
211
|
+
# CONTINUITY.md — Project Memory: Past Failures & Lessons
|
|
212
|
+
> Read at START of reason phase.
|
|
213
|
+
|
|
214
|
+
## Past Failures & Lessons
|
|
215
|
+
_No entries yet._
|
|
216
|
+
"@
|
|
217
|
+
|
|
218
|
+
Create-MemoryFile "CONTINUITY.md" $ContinuityContent
|
|
219
|
+
|
|
220
|
+
Write-Host ""
|
|
221
|
+
|
|
222
|
+
# -----------------------------------------------------------------------------
|
|
223
|
+
# Step 5: Update .gitignore
|
|
224
|
+
# -----------------------------------------------------------------------------
|
|
225
|
+
Write-Yellow "Step 5: Updating .gitignore"
|
|
226
|
+
|
|
227
|
+
$GitIgnore = "$ProjectRoot\.gitignore"
|
|
228
|
+
if (-not (Test-Path $GitIgnore)) { New-Item -ItemType File -Path $GitIgnore | Out-Null }
|
|
229
|
+
|
|
230
|
+
$CurrentIgnore = Get-Content $GitIgnore -Raw -ErrorAction SilentlyContinue
|
|
231
|
+
$AppendContent = ""
|
|
232
|
+
|
|
233
|
+
if ($CurrentIgnore -notmatch "\.env") { $AppendContent += "`n.env`n" }
|
|
234
|
+
if ($CurrentIgnore -notmatch "\.env\.local") { $AppendContent += ".env.local`n" }
|
|
235
|
+
if ($CurrentIgnore -notmatch "\.env\.*\.local") { $AppendContent += ".env.*.local`n" }
|
|
236
|
+
|
|
237
|
+
if ($AppendContent -ne "") {
|
|
238
|
+
Add-Content -Path $GitIgnore -Value $AppendContent
|
|
239
|
+
Write-Green "✓ Updated .gitignore"
|
|
240
|
+
} else {
|
|
241
|
+
Write-Yellow "! .gitignore already up to date"
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
Write-Host ""
|
|
245
|
+
Write-Green "======================================"
|
|
246
|
+
Write-Green " Context Unification Complete! "
|
|
247
|
+
Write-Green "======================================"
|
|
248
|
+
Write-Host "Kit is ready. Next steps:"
|
|
249
|
+
Write-Host " 1. Fill in AGENTS.md placeholders"
|
|
250
|
+
Write-Host " 2. Tell your AI: 'Read AGENTS.md and start with spec-writer skill'"
|
|
@@ -0,0 +1,398 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# setup-context.sh — Context Unification Script
|
|
3
|
+
# Run once per project to wire up agents/ kit for all AI coding tools.
|
|
4
|
+
#
|
|
5
|
+
# Usage: chmod +x agents/setup-context.sh && agents/setup-context.sh
|
|
6
|
+
#
|
|
7
|
+
# What this does:
|
|
8
|
+
# 1. Symlinks AGENTS.md -> all tool-specific context files
|
|
9
|
+
# 2. Symlinks agents/skills/ -> tool-specific skill directories
|
|
10
|
+
# 3. Creates agents/memory/ directory structure
|
|
11
|
+
# 4. Initializes starter memory files
|
|
12
|
+
# 5. Creates .gitignore entries for local-only files
|
|
13
|
+
|
|
14
|
+
set -e
|
|
15
|
+
|
|
16
|
+
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
17
|
+
AGENTS_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
|
|
18
|
+
PROJECT_ROOT="$(cd "${AGENTS_DIR}/.." && pwd)"
|
|
19
|
+
|
|
20
|
+
GREEN='\033[0;32m'
|
|
21
|
+
YELLOW='\033[1;33m'
|
|
22
|
+
BLUE='\033[0;34m'
|
|
23
|
+
RED='\033[0;31m'
|
|
24
|
+
NC='\033[0m' # No Color
|
|
25
|
+
|
|
26
|
+
echo ""
|
|
27
|
+
echo -e "${BLUE}======================================${NC}"
|
|
28
|
+
echo -e "${BLUE} Agentic Engineering Kit — Setup ${NC}"
|
|
29
|
+
echo -e "${BLUE}======================================${NC}"
|
|
30
|
+
echo ""
|
|
31
|
+
|
|
32
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
33
|
+
# Step 1: Symlink AGENTS.md to all AI tool context locations
|
|
34
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
35
|
+
echo -e "${YELLOW}Step 1: Unifying agent context (AGENTS.md -> all tools)${NC}"
|
|
36
|
+
|
|
37
|
+
# Claude Code: .claude/CLAUDE.md
|
|
38
|
+
if [ ! -d "${PROJECT_ROOT}/.claude" ]; then
|
|
39
|
+
mkdir -p "${PROJECT_ROOT}/.claude"
|
|
40
|
+
fi
|
|
41
|
+
if [ -L "${PROJECT_ROOT}/.claude/CLAUDE.md" ]; then
|
|
42
|
+
rm "${PROJECT_ROOT}/.claude/CLAUDE.md"
|
|
43
|
+
fi
|
|
44
|
+
if [ ! -f "${PROJECT_ROOT}/.claude/CLAUDE.md" ]; then
|
|
45
|
+
# Relative path: from .claude/ to agents/AGENTS.md
|
|
46
|
+
ln -sf "../agents/AGENTS.md" "${PROJECT_ROOT}/.claude/CLAUDE.md"
|
|
47
|
+
echo -e " ${GREEN}✓${NC} .claude/CLAUDE.md -> ../agents/AGENTS.md"
|
|
48
|
+
else
|
|
49
|
+
echo -e " ${YELLOW}!${NC} .claude/CLAUDE.md already exists (not a symlink — skipped)"
|
|
50
|
+
fi
|
|
51
|
+
|
|
52
|
+
# Cursor: .cursorrules
|
|
53
|
+
if [ -L "${PROJECT_ROOT}/.cursorrules" ]; then
|
|
54
|
+
rm "${PROJECT_ROOT}/.cursorrules"
|
|
55
|
+
fi
|
|
56
|
+
if [ ! -f "${PROJECT_ROOT}/.cursorrules" ]; then
|
|
57
|
+
# Relative path: from root to agents/AGENTS.md
|
|
58
|
+
ln -sf "agents/AGENTS.md" "${PROJECT_ROOT}/.cursorrules"
|
|
59
|
+
echo -e " ${GREEN}✓${NC} .cursorrules -> agents/AGENTS.md"
|
|
60
|
+
else
|
|
61
|
+
echo -e " ${YELLOW}!${NC} .cursorrules already exists (not a symlink — skipped)"
|
|
62
|
+
fi
|
|
63
|
+
|
|
64
|
+
# Gemini / Antigravity: .gemini/settings.json (agent_instructions field)
|
|
65
|
+
# Note: We create a wrapper settings.json that references AGENTS.md
|
|
66
|
+
if [ ! -d "${PROJECT_ROOT}/.gemini" ]; then
|
|
67
|
+
mkdir -p "${PROJECT_ROOT}/.gemini"
|
|
68
|
+
fi
|
|
69
|
+
if [ ! -f "${PROJECT_ROOT}/.gemini/settings.json" ]; then
|
|
70
|
+
cat > "${PROJECT_ROOT}/.gemini/settings.json" << 'EOF'
|
|
71
|
+
{
|
|
72
|
+
"agent_instructions_file": "../agents/AGENTS.md",
|
|
73
|
+
"skills_directory": "../agents/skills/",
|
|
74
|
+
"notes": "Managed by agents/setup-context.sh — do not edit manually"
|
|
75
|
+
}
|
|
76
|
+
EOF
|
|
77
|
+
echo -e " ${GREEN}✓${NC} .gemini/settings.json created (references agents/AGENTS.md)"
|
|
78
|
+
else
|
|
79
|
+
echo -e " ${YELLOW}!${NC} .gemini/settings.json already exists (skipped)"
|
|
80
|
+
fi
|
|
81
|
+
|
|
82
|
+
# Codex / OpenAI: .codex/AGENTS.md
|
|
83
|
+
if [ ! -d "${PROJECT_ROOT}/.codex" ]; then
|
|
84
|
+
mkdir -p "${PROJECT_ROOT}/.codex"
|
|
85
|
+
fi
|
|
86
|
+
if [ -L "${PROJECT_ROOT}/.codex/AGENTS.md" ]; then
|
|
87
|
+
rm "${PROJECT_ROOT}/.codex/AGENTS.md"
|
|
88
|
+
fi
|
|
89
|
+
if [ ! -f "${PROJECT_ROOT}/.codex/AGENTS.md" ]; then
|
|
90
|
+
# Relative path: from .codex/ to agents/AGENTS.md
|
|
91
|
+
ln -sf "../agents/AGENTS.md" "${PROJECT_ROOT}/.codex/AGENTS.md"
|
|
92
|
+
echo -e " ${GREEN}✓${NC} .codex/AGENTS.md -> ../agents/AGENTS.md"
|
|
93
|
+
else
|
|
94
|
+
echo -e " ${YELLOW}!${NC} .codex/AGENTS.md already exists (not a symlink — skipped)"
|
|
95
|
+
fi
|
|
96
|
+
|
|
97
|
+
# GitHub Copilot: .github/copilot-instructions.md
|
|
98
|
+
if [ ! -d "${PROJECT_ROOT}/.github" ]; then
|
|
99
|
+
mkdir -p "${PROJECT_ROOT}/.github"
|
|
100
|
+
fi
|
|
101
|
+
if [ -L "${PROJECT_ROOT}/.github/copilot-instructions.md" ]; then
|
|
102
|
+
rm "${PROJECT_ROOT}/.github/copilot-instructions.md"
|
|
103
|
+
fi
|
|
104
|
+
if [ ! -f "${PROJECT_ROOT}/.github/copilot-instructions.md" ]; then
|
|
105
|
+
# Relative path: from .github/ to agents/AGENTS.md
|
|
106
|
+
ln -sf "../agents/AGENTS.md" "${PROJECT_ROOT}/.github/copilot-instructions.md"
|
|
107
|
+
echo -e " ${GREEN}✓${NC} .github/copilot-instructions.md -> ../agents/AGENTS.md"
|
|
108
|
+
else
|
|
109
|
+
echo -e " ${YELLOW}!${NC} .github/copilot-instructions.md already exists (not a symlink — skipped)"
|
|
110
|
+
fi
|
|
111
|
+
|
|
112
|
+
echo ""
|
|
113
|
+
|
|
114
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
115
|
+
# Step 2: Symlink agents/skills/ to tool-specific skill directories
|
|
116
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
117
|
+
echo -e "${YELLOW}Step 2: Wiring skills directories${NC}"
|
|
118
|
+
|
|
119
|
+
# Claude Code: .claude/skills/
|
|
120
|
+
if [ ! -d "${PROJECT_ROOT}/.claude" ]; then
|
|
121
|
+
mkdir -p "${PROJECT_ROOT}/.claude"
|
|
122
|
+
fi
|
|
123
|
+
if [ -L "${PROJECT_ROOT}/.claude/skills" ]; then
|
|
124
|
+
rm "${PROJECT_ROOT}/.claude/skills"
|
|
125
|
+
fi
|
|
126
|
+
if [ ! -d "${PROJECT_ROOT}/.claude/skills" ]; then
|
|
127
|
+
# Relative path: from .claude/ to agents/skills/
|
|
128
|
+
ln -sf "../agents/skills" "${PROJECT_ROOT}/.claude/skills"
|
|
129
|
+
echo -e " ${GREEN}✓${NC} .claude/skills/ -> ../agents/skills/"
|
|
130
|
+
else
|
|
131
|
+
echo -e " ${YELLOW}!${NC} .claude/skills/ already exists (not a symlink — skipped)"
|
|
132
|
+
fi
|
|
133
|
+
|
|
134
|
+
# Antigravity / Gemini: .agent/skills/
|
|
135
|
+
if [ ! -d "${PROJECT_ROOT}/.agent" ]; then
|
|
136
|
+
mkdir -p "${PROJECT_ROOT}/.agent"
|
|
137
|
+
fi
|
|
138
|
+
if [ -L "${PROJECT_ROOT}/.agent/skills" ]; then
|
|
139
|
+
rm "${PROJECT_ROOT}/.agent/skills"
|
|
140
|
+
fi
|
|
141
|
+
if [ ! -d "${PROJECT_ROOT}/.agent/skills" ]; then
|
|
142
|
+
# Relative path: from .agent/ to agents/skills/
|
|
143
|
+
ln -sf "../agents/skills" "${PROJECT_ROOT}/.agent/skills"
|
|
144
|
+
echo -e " ${GREEN}✓${NC} .agent/skills/ -> ../agents/skills/"
|
|
145
|
+
else
|
|
146
|
+
echo -e " ${YELLOW}!${NC} .agent/skills/ already exists (not a symlink — skipped)"
|
|
147
|
+
fi
|
|
148
|
+
|
|
149
|
+
# Cursor and VS Code: Compile skills
|
|
150
|
+
if [ -f "${AGENTS_DIR}/scripts/compile_skills.py" ]; then
|
|
151
|
+
echo -e "${YELLOW}Compiling skills for Cursor and VS Code...${NC}"
|
|
152
|
+
|
|
153
|
+
# Cursor
|
|
154
|
+
python3 "${AGENTS_DIR}/scripts/compile_skills.py" \
|
|
155
|
+
--platform "Cursor" \
|
|
156
|
+
--skills-dir "${AGENTS_DIR}/skills" \
|
|
157
|
+
--target-dir "${PROJECT_ROOT}/.cursor/rules" \
|
|
158
|
+
--project-root "${PROJECT_ROOT}"
|
|
159
|
+
|
|
160
|
+
# VS Code / Copilot
|
|
161
|
+
python3 "${AGENTS_DIR}/scripts/compile_skills.py" \
|
|
162
|
+
--platform "VS Code" \
|
|
163
|
+
--skills-dir "${AGENTS_DIR}/skills" \
|
|
164
|
+
--target-dir "${PROJECT_ROOT}/.github/skills" \
|
|
165
|
+
--project-root "${PROJECT_ROOT}"
|
|
166
|
+
else
|
|
167
|
+
echo -e "${RED}x Warning: compile_skills.py not found. Skipping Cursor/VS Code skill generation.${NC}"
|
|
168
|
+
fi
|
|
169
|
+
|
|
170
|
+
echo ""
|
|
171
|
+
|
|
172
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
173
|
+
# Step 3: Create agents/memory/ directory structure
|
|
174
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
175
|
+
echo -e "${YELLOW}Step 3: Initializing agents/memory/ directory structure${NC}"
|
|
176
|
+
|
|
177
|
+
MEMORY_DIR="${AGENTS_DIR}/memory"
|
|
178
|
+
mkdir -p "${MEMORY_DIR}/episodic/SESSION_SNAPSHOT"
|
|
179
|
+
mkdir -p "${MEMORY_DIR}/semantic"
|
|
180
|
+
echo -e " ${GREEN}✓${NC} agents/memory/episodic/SESSION_SNAPSHOT/ created"
|
|
181
|
+
echo -e " ${GREEN}✓${NC} agents/memory/semantic/ created"
|
|
182
|
+
|
|
183
|
+
echo ""
|
|
184
|
+
|
|
185
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
186
|
+
# Step 4: Initialize starter memory files (if not already present)
|
|
187
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
188
|
+
echo -e "${YELLOW}Step 4: Initializing memory files${NC}"
|
|
189
|
+
|
|
190
|
+
# PROJECT_STATE.md
|
|
191
|
+
if [ ! -f "${MEMORY_DIR}/PROJECT_STATE.md" ]; then
|
|
192
|
+
cat > "${MEMORY_DIR}/PROJECT_STATE.md" << 'EOF'
|
|
193
|
+
# PROJECT_STATE.md — Master Project State
|
|
194
|
+
|
|
195
|
+
> Updated by: sdlc-checkpoint.skill
|
|
196
|
+
> Read by: session-resume.skill, loki-mode.skill
|
|
197
|
+
|
|
198
|
+
## Current SDLC Phase
|
|
199
|
+
|
|
200
|
+
```
|
|
201
|
+
Phase: S00_INITIALIZED
|
|
202
|
+
Status: NOT_STARTED
|
|
203
|
+
Last checkpoint: [DATE]
|
|
204
|
+
Last checkpoint by: [agent/human]
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
## SDLC Progress
|
|
208
|
+
|
|
209
|
+
| Phase | Status | Started | Completed | Gate Criteria Met |
|
|
210
|
+
|---|---|---|---|---|
|
|
211
|
+
| S01 Requirements | NOT_STARTED | — | — | — |
|
|
212
|
+
| S02 Design | NOT_STARTED | — | — | — |
|
|
213
|
+
| S03 Specification | NOT_STARTED | — | — | — |
|
|
214
|
+
| S04 Tasks | NOT_STARTED | — | — | — |
|
|
215
|
+
| S05 Implementation | NOT_STARTED | — | — | — |
|
|
216
|
+
| S06 Testing | NOT_STARTED | — | — | — |
|
|
217
|
+
| S07 Security | NOT_STARTED | — | — | — |
|
|
218
|
+
| S08 Review | NOT_STARTED | — | — | — |
|
|
219
|
+
| S09 Staging | NOT_STARTED | — | — | — |
|
|
220
|
+
| S10 Production | NOT_STARTED | — | — | — |
|
|
221
|
+
|
|
222
|
+
## Current Blockers
|
|
223
|
+
|
|
224
|
+
_None yet_
|
|
225
|
+
|
|
226
|
+
## Next Actions
|
|
227
|
+
|
|
228
|
+
1. Fill in AGENTS.md placeholders for this project
|
|
229
|
+
2. Run spec-writer.skill to create initial PRD.md
|
|
230
|
+
|
|
231
|
+
## Open Human Decisions
|
|
232
|
+
|
|
233
|
+
_None pending_
|
|
234
|
+
|
|
235
|
+
## Last Test Status
|
|
236
|
+
|
|
237
|
+
```
|
|
238
|
+
Last run: never
|
|
239
|
+
Pass: — Fail: — Skip: —
|
|
240
|
+
Coverage: —
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
## Key Artifacts
|
|
244
|
+
|
|
245
|
+
```
|
|
246
|
+
PRD.md: does not exist
|
|
247
|
+
SPEC.md: does not exist
|
|
248
|
+
PLAN.md: does not exist
|
|
249
|
+
project/TASKS.md: does not exist
|
|
250
|
+
```
|
|
251
|
+
EOF
|
|
252
|
+
echo -e " ${GREEN}✓${NC} agents/memory/PROJECT_STATE.md initialized"
|
|
253
|
+
else
|
|
254
|
+
echo -e " ${YELLOW}!${NC} agents/memory/PROJECT_STATE.md already exists (skipped)"
|
|
255
|
+
fi
|
|
256
|
+
|
|
257
|
+
# AUDIT_LOG.md
|
|
258
|
+
if [ ! -f "${MEMORY_DIR}/AUDIT_LOG.md" ]; then
|
|
259
|
+
cat > "${MEMORY_DIR}/AUDIT_LOG.md" << 'EOF'
|
|
260
|
+
# AUDIT_LOG.md — Project Audit Trail
|
|
261
|
+
|
|
262
|
+
> APPEND ONLY — never delete or modify existing entries.
|
|
263
|
+
> Updated by: audit-trail.skill
|
|
264
|
+
> Read by: session-resume.skill (last 50 entries), integrity-check.skill
|
|
265
|
+
|
|
266
|
+
## Log Format
|
|
267
|
+
|
|
268
|
+
| Timestamp | Session | Agent/Human | Action Type | Description | Outcome | References |
|
|
269
|
+
|---|---|---|---|---|---|---|
|
|
270
|
+
|
|
271
|
+
## Action Types
|
|
272
|
+
- DECISION — a choice was made between options
|
|
273
|
+
- PHASE_TRANSITION — SDLC phase changed
|
|
274
|
+
- TASK_DONE — a task was completed
|
|
275
|
+
- TASK_BLOCKED — a task is stuck, human needed
|
|
276
|
+
- QUALITY_GATE — gate pass/fail result
|
|
277
|
+
- SECURITY_FINDING — security issue found
|
|
278
|
+
- ADR_CREATED — architecture decision recorded
|
|
279
|
+
- HUMAN_ESCALATION — agent escalated to human
|
|
280
|
+
- SELF_HEAL_ATTEMPT — agent tried to fix itself
|
|
281
|
+
- RESEARCH_FINDING — authoritative source found
|
|
282
|
+
- ERROR — unexpected error encountered
|
|
283
|
+
- ROLLBACK — change was reverted
|
|
284
|
+
|
|
285
|
+
## Log Entries
|
|
286
|
+
|
|
287
|
+
| Timestamp | Session | Agent/Human | Action Type | Description | Outcome | References |
|
|
288
|
+
|---|---|---|---|---|---|---|
|
|
289
|
+
| INIT | S00 | setup-context.sh | PHASE_TRANSITION | Kit initialized | SUCCESS | README_FULL.md |
|
|
290
|
+
|
|
291
|
+
EOF
|
|
292
|
+
echo -e " ${GREEN}✓${NC} agents/memory/AUDIT_LOG.md initialized"
|
|
293
|
+
else
|
|
294
|
+
echo -e " ${YELLOW}!${NC} agents/memory/AUDIT_LOG.md already exists (skipped)"
|
|
295
|
+
fi
|
|
296
|
+
|
|
297
|
+
# CONTINUITY.md
|
|
298
|
+
if [ ! -f "${MEMORY_DIR}/CONTINUITY.md" ]; then
|
|
299
|
+
cat > "${MEMORY_DIR}/CONTINUITY.md" << 'EOF'
|
|
300
|
+
# CONTINUITY.md — Project Memory: Past Failures & Lessons
|
|
301
|
+
|
|
302
|
+
> Read this at the START of every RARV Reason phase.
|
|
303
|
+
> Prevents repeating failed approaches across sessions.
|
|
304
|
+
> Updated by: self-heal.skill (on escalation), audit-trail.skill
|
|
305
|
+
|
|
306
|
+
## How to Add Entries
|
|
307
|
+
|
|
308
|
+
When an approach fails after multiple attempts, add an entry:
|
|
309
|
+
|
|
310
|
+
```markdown
|
|
311
|
+
### [DATE] — [Brief title of the failure]
|
|
312
|
+
**Context:** What were you trying to do?
|
|
313
|
+
**Approach tried:** What did you try?
|
|
314
|
+
**Why it failed:** Root cause
|
|
315
|
+
**Resolution:** What actually worked (or "unresolved — awaiting human decision")
|
|
316
|
+
**Tags:** [library-conflict | type-error | test-failure | architecture | security | performance]
|
|
317
|
+
```
|
|
318
|
+
|
|
319
|
+
## Past Failures & Lessons
|
|
320
|
+
|
|
321
|
+
_No entries yet. Entries are added automatically by self-heal.skill on escalation._
|
|
322
|
+
|
|
323
|
+
EOF
|
|
324
|
+
echo -e " ${GREEN}✓${NC} agents/memory/CONTINUITY.md initialized"
|
|
325
|
+
else
|
|
326
|
+
echo -e " ${YELLOW}!${NC} agents/memory/CONTINUITY.md already exists (skipped)"
|
|
327
|
+
fi
|
|
328
|
+
|
|
329
|
+
echo ""
|
|
330
|
+
|
|
331
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
332
|
+
# Step 5: Update .gitignore
|
|
333
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
334
|
+
echo -e "${YELLOW}Step 5: Updating .gitignore${NC}"
|
|
335
|
+
|
|
336
|
+
GITIGNORE="${PROJECT_ROOT}/.gitignore"
|
|
337
|
+
|
|
338
|
+
add_to_gitignore() {
|
|
339
|
+
local entry="$1"
|
|
340
|
+
local comment="$2"
|
|
341
|
+
if ! grep -qF "$entry" "$GITIGNORE" 2>/dev/null; then
|
|
342
|
+
echo "" >> "$GITIGNORE"
|
|
343
|
+
echo "# $comment" >> "$GITIGNORE"
|
|
344
|
+
echo "$entry" >> "$GITIGNORE"
|
|
345
|
+
echo -e " ${GREEN}✓${NC} Added $entry to .gitignore"
|
|
346
|
+
else
|
|
347
|
+
echo -e " ${YELLOW}!${NC} $entry already in .gitignore (skipped)"
|
|
348
|
+
fi
|
|
349
|
+
}
|
|
350
|
+
|
|
351
|
+
# Create .gitignore if it doesn't exist
|
|
352
|
+
if [ ! -f "$GITIGNORE" ]; then
|
|
353
|
+
touch "$GITIGNORE"
|
|
354
|
+
echo -e " ${GREEN}✓${NC} Created .gitignore"
|
|
355
|
+
fi
|
|
356
|
+
|
|
357
|
+
add_to_gitignore ".env" "Environment secrets"
|
|
358
|
+
add_to_gitignore ".env.local" "Local environment overrides"
|
|
359
|
+
add_to_gitignore ".env.*.local" "Environment-specific local overrides"
|
|
360
|
+
|
|
361
|
+
# Note: we do NOT gitignore agents/memory/ — project memory should be committed
|
|
362
|
+
# to preserve continuity across team members and CI/CD environments.
|
|
363
|
+
# Individual developers may add local-only entries to .git/info/exclude.
|
|
364
|
+
|
|
365
|
+
echo ""
|
|
366
|
+
|
|
367
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
368
|
+
# Optional: Global skills symlink (for cross-project availability)
|
|
369
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
370
|
+
echo -e "${YELLOW}Optional: Global skills setup${NC}"
|
|
371
|
+
echo -e " To make these skills available globally across all projects, run:"
|
|
372
|
+
echo -e " ${BLUE}mkdir -p ~/.claude/skills && ln -sf ${AGENTS_DIR}/skills/* ~/.claude/skills/${NC}"
|
|
373
|
+
echo -e " Or for Gemini/Antigravity:"
|
|
374
|
+
echo -e " ${BLUE}mkdir -p ~/.agent/skills && ln -sf ${AGENTS_DIR}/skills/* ~/.agent/skills/${NC}"
|
|
375
|
+
echo ""
|
|
376
|
+
|
|
377
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
378
|
+
# Done
|
|
379
|
+
# ─────────────────────────────────────────────────────────────────────────────
|
|
380
|
+
echo -e "${GREEN}======================================${NC}"
|
|
381
|
+
echo -e "${GREEN} Context Unification Complete! ${NC}"
|
|
382
|
+
echo -e "${GREEN}======================================${NC}"
|
|
383
|
+
echo ""
|
|
384
|
+
echo -e "Kit is ready. Next steps:"
|
|
385
|
+
echo -e " 1. ${BLUE}Fill in AGENTS.md placeholders${NC} for your project"
|
|
386
|
+
echo -e " 2. ${BLUE}Adapt CONSTITUTION.md${NC} — keep universal articles, add project-specific ones"
|
|
387
|
+
echo -e " 3. Tell your AI agent: ${BLUE}\"Read AGENTS.md and start with spec-writer skill\"${NC}"
|
|
388
|
+
echo ""
|
|
389
|
+
echo -e "Files created/linked:"
|
|
390
|
+
echo -e " .claude/CLAUDE.md -> agents/AGENTS.md"
|
|
391
|
+
echo -e " .cursorrules -> agents/AGENTS.md"
|
|
392
|
+
echo -e " .codex/AGENTS.md -> agents/AGENTS.md"
|
|
393
|
+
echo -e " .github/copilot-instructions.md -> agents/AGENTS.md"
|
|
394
|
+
echo -e " .gemini/settings.json (references agents/AGENTS.md)"
|
|
395
|
+
echo -e " .claude/skills/ -> agents/skills/"
|
|
396
|
+
echo -e " .agent/skills/ -> agents/skills/"
|
|
397
|
+
echo -e " agents/memory/ (initialized)"
|
|
398
|
+
echo ""
|