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,162 @@
|
|
|
1
|
+
# Implementation Plan: [Feature Name]
|
|
2
|
+
<!-- Derived from: SPEC_TEMPLATE.md — do not start before spec is approved -->
|
|
3
|
+
<!-- Created by: prod-architect | Date: [date] -->
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 1. Overview
|
|
8
|
+
|
|
9
|
+
**Feature:** [Name]
|
|
10
|
+
**Spec Reference:** [link to SPEC_TEMPLATE.md]
|
|
11
|
+
**Estimated phases:** [N]
|
|
12
|
+
**Dependencies:** [External dependencies — library upgrades, other features, team dependencies]
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## 2. Implementation Phases
|
|
17
|
+
|
|
18
|
+
### Phase 1 — [Foundation / Domain Layer]
|
|
19
|
+
**Goal:** [What will be working after this phase]
|
|
20
|
+
|
|
21
|
+
**Files to create:**
|
|
22
|
+
```
|
|
23
|
+
src/domain/[entity].ts - Entity definition + invariants
|
|
24
|
+
src/domain/events/[event].ts - Domain events
|
|
25
|
+
src/domain/value-objects/[vo].ts - Value objects
|
|
26
|
+
src/domain/ports/[repo-interface].ts - Repository interface (IRepository)
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
**Files to modify:**
|
|
30
|
+
```
|
|
31
|
+
[none in Phase 1 — foundation only]
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
**Acceptance criteria for this phase:**
|
|
35
|
+
- [ ] Domain entity tests pass
|
|
36
|
+
- [ ] Value object validation tests pass
|
|
37
|
+
- [ ] No framework imports in domain layer
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
### Phase 2 — [Application Layer]
|
|
42
|
+
**Goal:** [What will be working after this phase]
|
|
43
|
+
**Depends on:** Phase 1 complete
|
|
44
|
+
|
|
45
|
+
**Files to create:**
|
|
46
|
+
```
|
|
47
|
+
src/application/[feature]/[action]-[entity].use-case.ts
|
|
48
|
+
src/application/[feature]/[action]-[entity].command.ts
|
|
49
|
+
src/application/[feature]/[action]-[entity].result.ts
|
|
50
|
+
tests/unit/application/[action]-[entity].use-case.test.ts
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
**Acceptance criteria for this phase:**
|
|
54
|
+
- [ ] Use case unit tests pass with mocked repository
|
|
55
|
+
- [ ] Use case is framework-agnostic (testable without HTTP or DB)
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
### Phase 3 — [Infrastructure Layer]
|
|
60
|
+
**Goal:** [What will be working after this phase]
|
|
61
|
+
**Depends on:** Phase 1 complete (needs domain interfaces)
|
|
62
|
+
|
|
63
|
+
**Files to create:**
|
|
64
|
+
```
|
|
65
|
+
src/infrastructure/[entity]/prisma-[entity].repository.ts
|
|
66
|
+
prisma/migrations/[timestamp]_[migration-name]/migration.sql
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
**Files to modify:**
|
|
70
|
+
```
|
|
71
|
+
prisma/schema.prisma - Add new model
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
**Acceptance criteria for this phase:**
|
|
75
|
+
- [ ] Repository integration tests pass against test DB
|
|
76
|
+
- [ ] Migration runs forward and backward without errors
|
|
77
|
+
- [ ] All existing tests still pass
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
### Phase 4 — [Adapters / API Layer]
|
|
82
|
+
**Goal:** [What will be working after this phase]
|
|
83
|
+
**Depends on:** Phase 2 and Phase 3 complete
|
|
84
|
+
|
|
85
|
+
**Files to create:**
|
|
86
|
+
```
|
|
87
|
+
src/adapters/http/[entity].controller.ts
|
|
88
|
+
src/adapters/http/[entity].dto.ts - Zod schema for request validation
|
|
89
|
+
tests/integration/api/[entity].test.ts
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
**Acceptance criteria for this phase:**
|
|
93
|
+
- [ ] POST /api/v1/[resource] returns 201 with valid input
|
|
94
|
+
- [ ] Returns 422 with field errors for invalid input
|
|
95
|
+
- [ ] Returns 401 when unauthenticated
|
|
96
|
+
- [ ] Integration tests pass
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
### Phase 5 — [Wiring / Bootstrap]
|
|
101
|
+
**Goal:** Full feature wired and functional end-to-end
|
|
102
|
+
**Depends on:** All previous phases complete
|
|
103
|
+
|
|
104
|
+
**Files to modify:**
|
|
105
|
+
```
|
|
106
|
+
src/main/container.ts - Register new dependencies in DI container
|
|
107
|
+
src/main/routes.ts - Register new routes
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
**Acceptance criteria for this phase:**
|
|
111
|
+
- [ ] Full end-to-end test passes (registration → login → use feature)
|
|
112
|
+
- [ ] All tests pass (unit + integration)
|
|
113
|
+
- [ ] No new circular dependencies (run madge)
|
|
114
|
+
- [ ] Lint and typecheck pass
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## 3. Dependencies Between Phases
|
|
119
|
+
|
|
120
|
+
```
|
|
121
|
+
Phase 1 (Domain)
|
|
122
|
+
└─> Phase 2 (Application) — depends on domain entities and interfaces
|
|
123
|
+
└─> Phase 3 (Infrastructure) — depends on domain interfaces
|
|
124
|
+
|
|
125
|
+
Phase 2 + Phase 3 complete
|
|
126
|
+
└─> Phase 4 (Adapters)
|
|
127
|
+
|
|
128
|
+
Phase 1 + 2 + 3 + 4 complete
|
|
129
|
+
└─> Phase 5 (Wiring)
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## 4. Risk & Assumptions Log
|
|
135
|
+
|
|
136
|
+
| # | Risk/Assumption | Likelihood | Impact | Mitigation |
|
|
137
|
+
|---|---|---|---|---|
|
|
138
|
+
| 1 | [Risk: Database migration may lock table] | M | H | Use pt-online-schema-change or test on production-sized dataset |
|
|
139
|
+
| 2 | [Assumption: Auth middleware already in place] | — | H | Verify in Phase 4 — fallback: implement basic auth in this phase |
|
|
140
|
+
| 3 | [Risk: External API rate limits] | L | M | Add retry with exponential backoff in infrastructure layer |
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
## 5. Testing Strategy per Phase
|
|
145
|
+
|
|
146
|
+
| Phase | Test Type | Command | Pass Criteria |
|
|
147
|
+
|---|---|---|---|
|
|
148
|
+
| 1 | Unit | `[test cmd] tests/unit/domain/` | All pass |
|
|
149
|
+
| 2 | Unit | `[test cmd] tests/unit/application/` | All pass |
|
|
150
|
+
| 3 | Integration | `[test cmd] tests/integration/db/` | All pass against test DB |
|
|
151
|
+
| 4 | Integration | `[test cmd] tests/integration/api/` | All pass |
|
|
152
|
+
| 5 | E2E | `[test cmd] tests/e2e/` | Happy path passes |
|
|
153
|
+
|
|
154
|
+
---
|
|
155
|
+
|
|
156
|
+
## 6. Approval
|
|
157
|
+
|
|
158
|
+
| Role | Name | Status | Date |
|
|
159
|
+
|---|---|---|---|
|
|
160
|
+
| Tech Lead | [name] | [APPROVED / PENDING] | [date] |
|
|
161
|
+
|
|
162
|
+
**Human approval required before decomposing into tasks (S04).**
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# Project Retrospective: [Project / Milestone Name]
|
|
2
|
+
|
|
3
|
+
**Date:** [YYYY-MM-DD]
|
|
4
|
+
**Facilitator:** [name]
|
|
5
|
+
**Participants:** [names or roles]
|
|
6
|
+
**Period covered:** [start] → [end]
|
|
7
|
+
**Status:** Draft | Final
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## 1. Metadata
|
|
12
|
+
|
|
13
|
+
| Field | Value |
|
|
14
|
+
|---|---|
|
|
15
|
+
| Project | [name] |
|
|
16
|
+
| Outcome | [Shipped / Cancelled / Pivoted / Ongoing] |
|
|
17
|
+
| Planned vs actual duration | [e.g. "6w planned, 9w actual"] |
|
|
18
|
+
| Team size | [N] |
|
|
19
|
+
| Key metrics | [e.g. defects, velocity, SLO attainment] |
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## 2. Timeline
|
|
24
|
+
|
|
25
|
+
<!-- A short factual sequence of events. No blame, just what happened and when. -->
|
|
26
|
+
|
|
27
|
+
| Date | Event / milestone | Note |
|
|
28
|
+
|---|---|---|
|
|
29
|
+
| [YYYY-MM-DD] | [Kickoff / decision / incident / launch] | [ ] |
|
|
30
|
+
| [ ] | [ ] | [ ] |
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## 3. Reflection
|
|
35
|
+
|
|
36
|
+
### What went well
|
|
37
|
+
- [Practice or outcome worth repeating]
|
|
38
|
+
- [ ]
|
|
39
|
+
|
|
40
|
+
### What didn't go well
|
|
41
|
+
- [Problem, friction, or miss]
|
|
42
|
+
- [ ]
|
|
43
|
+
|
|
44
|
+
### Puzzles (things we still don't understand)
|
|
45
|
+
- [Open question or surprising result we couldn't explain]
|
|
46
|
+
- [ ]
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## 4. Action Items
|
|
51
|
+
|
|
52
|
+
<!-- Every action must have a single owner and a date, or it won't happen. -->
|
|
53
|
+
|
|
54
|
+
| Action | Owner | Due | Status |
|
|
55
|
+
|---|---|---|---|
|
|
56
|
+
| [Concrete, verifiable change] | [name] | [YYYY-MM-DD] | [Open/In progress/Done] |
|
|
57
|
+
| [ ] | [ ] | [ ] | [ ] |
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## 5. Lessons to Carry Forward
|
|
62
|
+
|
|
63
|
+
<!-- Durable lessons get promoted to CONTINUITY.md so future work inherits them.
|
|
64
|
+
Keep these general enough to apply beyond this one project. -->
|
|
65
|
+
|
|
66
|
+
- [Lesson to record in CONTINUITY.md]
|
|
67
|
+
- [ ]
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
# SDLC Tracker
|
|
2
|
+
<!-- Updated by: sdlc-checkpoint.skill | Read by: session-resume.skill, integrity-check.skill -->
|
|
3
|
+
<!-- Project: [Project Name] | Started: [date] -->
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Current Status
|
|
8
|
+
|
|
9
|
+
```
|
|
10
|
+
Current Phase: S[XX] — [Phase Name]
|
|
11
|
+
Status: NOT_STARTED | IN_PROGRESS | BLOCKED | COMPLETED
|
|
12
|
+
Last updated: [date]
|
|
13
|
+
Updated by: [agent/human]
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## Phase Progress Board
|
|
19
|
+
|
|
20
|
+
| Phase | Name | Status | Started | Completed | Approver | Gate Criteria |
|
|
21
|
+
|---|---|---|---|---|---|---|
|
|
22
|
+
| S00 | Strategy & Discovery (Day-0) | NOT_STARTED | — | — | — | Problem statement + opportunity assessment + RICE, human GO/NO-GO |
|
|
23
|
+
| S01 | Requirements | NOT_STARTED | — | — | — | PRD.md with EARS, human approval |
|
|
24
|
+
| S02 | Design | NOT_STARTED | — | — | — | Architecture + ADRs + threat model |
|
|
25
|
+
| S03 | Specification | NOT_STARTED | — | — | — | Tech spec + API contracts |
|
|
26
|
+
| S04 | Tasks | NOT_STARTED | — | — | — | All tasks decomposed to 15-min units |
|
|
27
|
+
| S05 | Implementation | NOT_STARTED | — | — | — | All project/TASKS.md items DONE |
|
|
28
|
+
| S06 | Testing | NOT_STARTED | — | — | — | Tests pass, coverage ≥ 99%, 7 gates |
|
|
29
|
+
| S07 | Security | NOT_STARTED | — | — | — | SECURITY_CHECKLIST.md 100%, 0 critical CVEs |
|
|
30
|
+
| S08 | Review | NOT_STARTED | — | — | — | Human code review approved |
|
|
31
|
+
| S09 | Staging | NOT_STARTED | — | — | — | Deployed + smoke tests passing |
|
|
32
|
+
| S10 | Production | NOT_STARTED | — | — | — | Deployed + rollback documented |
|
|
33
|
+
| S11 | Operate & Maintain (Day-2) | NOT_STARTED | — | — | — | SLOs met, runbooks live, no critical CVEs, spend within budget |
|
|
34
|
+
| S12 | Evolve & Improve (Day-2) | NOT_STARTED | — | — | — | Retrospective actions logged, experiments decided, DORA/SPACE reviewed |
|
|
35
|
+
| S13 | Decommission & Sunset (Day-2) | NOT_STARTED | — | — | — | Deprecation approved, data archived/migrated, users notified |
|
|
36
|
+
|
|
37
|
+
**Status values:** `NOT_STARTED` | `IN_PROGRESS` | `BLOCKED` | `COMPLETED`
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## Definition of Done — Per Phase
|
|
42
|
+
|
|
43
|
+
### S00 — Strategy & Discovery (Day-0)
|
|
44
|
+
```
|
|
45
|
+
[ ] Problem statement drafted (job-to-be-done, who hurts, why now)
|
|
46
|
+
[ ] Opportunity assessment complete (sizing, risks, North-Star + HEART metrics)
|
|
47
|
+
[ ] Market/competitive scan + Wardley map captured
|
|
48
|
+
[ ] Candidate bets prioritized with RICE
|
|
49
|
+
[ ] Human GO/NO-GO decision recorded (GO required to start S01)
|
|
50
|
+
[ ] SESSION_SNAPSHOT/S00_discovery.md created
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
### S01 — Requirements
|
|
54
|
+
```
|
|
55
|
+
[ ] PRD.md created using PRD_TEMPLATE.md
|
|
56
|
+
[ ] All requirements written in EARS syntax (no "should" or "might")
|
|
57
|
+
[ ] Ambiguity layer completed — no unresolved questions
|
|
58
|
+
[ ] Out-of-scope section filled
|
|
59
|
+
[ ] Human explicitly approved PRD.md
|
|
60
|
+
[ ] SESSION_SNAPSHOT/S01_requirements.md created
|
|
61
|
+
[ ] AUDIT_LOG.md entry: HUMAN_APPROVED
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### S02 — Design
|
|
65
|
+
```
|
|
66
|
+
[ ] Architecture approach documented in PLAN.md
|
|
67
|
+
[ ] C4 Level 1+2 diagrams in docs/architecture/ (or documented exception)
|
|
68
|
+
[ ] ADR created for every significant technology choice
|
|
69
|
+
[ ] Threat model completed for ALL security-sensitive features
|
|
70
|
+
[ ] Human approved architecture approach
|
|
71
|
+
[ ] SESSION_SNAPSHOT/S02_design.md created
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
### S03 — Specification
|
|
75
|
+
```
|
|
76
|
+
[ ] SPEC_TEMPLATE.md completed: domain model, API contracts, DB changes
|
|
77
|
+
[ ] OpenAPI spec at docs/api/openapi.yaml (or equivalent)
|
|
78
|
+
[ ] Migration plan documented (if DB changes)
|
|
79
|
+
[ ] Testing strategy defined per layer
|
|
80
|
+
[ ] Human approved technical specification
|
|
81
|
+
[ ] SESSION_SNAPSHOT/S03_specification.md created
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### S04 — Tasks
|
|
85
|
+
```
|
|
86
|
+
[ ] All PLAN.md items decomposed into TASKS_TEMPLATE.md
|
|
87
|
+
[ ] Each task: achievable in ~15 minutes
|
|
88
|
+
[ ] Each task: has testable acceptance criteria
|
|
89
|
+
[ ] Tasks have correct dependency ordering
|
|
90
|
+
[ ] No ambiguous tasks ("do the stuff" — must be specific files/functions)
|
|
91
|
+
[ ] SESSION_SNAPSHOT/S04_TASKS.md created
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
### S05 — Implementation
|
|
95
|
+
```
|
|
96
|
+
[ ] All tasks in project/TASKS.md have status DONE (none TODO/IN_PROGRESS/BLOCKED)
|
|
97
|
+
[ ] TDD followed for each task: failing test written first
|
|
98
|
+
[ ] Each task commit references the task ID
|
|
99
|
+
[ ] AUDIT_LOG.md has TASK_DONE entry for each task
|
|
100
|
+
[ ] SESSION_SNAPSHOT/S05_implementation.md created
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### S06 — Testing
|
|
104
|
+
```
|
|
105
|
+
[ ] [test command] passes: 0 failing, 0 unexpected skips
|
|
106
|
+
[ ] Coverage >= 99% (run [coverage command])
|
|
107
|
+
[ ] Gate 1 Lint: 0 errors
|
|
108
|
+
[ ] Gate 2 Typecheck: 0 errors
|
|
109
|
+
[ ] Gate 3 Coverage: >= 99%
|
|
110
|
+
[ ] Gate 4 Integration: Docker Compose tests pass
|
|
111
|
+
[ ] Gate 5 Security: npm/composer audit clean (0 critical/high CVEs)
|
|
112
|
+
[ ] Gate 6 Complexity: max cyclomatic complexity < 10
|
|
113
|
+
[ ] Gate 7 EARS compliance: all requirements have tests
|
|
114
|
+
[ ] agentic-linter: 0 architecture violations
|
|
115
|
+
[ ] SESSION_SNAPSHOT/S06_testing.md created
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
### S07 — Security
|
|
119
|
+
```
|
|
120
|
+
[ ] security-audit.skill run on full codebase
|
|
121
|
+
[ ] SECURITY_CHECKLIST.md 100% complete
|
|
122
|
+
[ ] 0 critical CVEs in dependencies
|
|
123
|
+
[ ] 0 high CVEs unresolved (or risk accepted by human)
|
|
124
|
+
[ ] gitleaks detect: CLEAN (no secrets in git)
|
|
125
|
+
[ ] All threat model mitigations implemented
|
|
126
|
+
[ ] Human security approval
|
|
127
|
+
[ ] SESSION_SNAPSHOT/S07_security.md created
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
### S08 — Review
|
|
131
|
+
```
|
|
132
|
+
[ ] PR created with complete description
|
|
133
|
+
[ ] Human reviewer has reviewed all changes
|
|
134
|
+
[ ] All reviewer comments addressed
|
|
135
|
+
[ ] No "RESOLVE LATER" comments (all blocking feedback resolved)
|
|
136
|
+
[ ] PR approved and merge ready
|
|
137
|
+
[ ] SESSION_SNAPSHOT/S08_review.md created
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
### S09 — Staging
|
|
141
|
+
```
|
|
142
|
+
[ ] Deployed to staging environment
|
|
143
|
+
[ ] Database migrations applied to staging
|
|
144
|
+
[ ] Smoke tests passing (health check + core user flows)
|
|
145
|
+
[ ] No error spike in monitoring after deploy
|
|
146
|
+
[ ] Performance within acceptable range
|
|
147
|
+
[ ] SESSION_SNAPSHOT/S09_staging.md created
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
### S10 — Production
|
|
151
|
+
```
|
|
152
|
+
[ ] Production deploy completed
|
|
153
|
+
[ ] Database migrations applied to production
|
|
154
|
+
[ ] Smoke tests passing in production
|
|
155
|
+
[ ] Monitoring/alerting active for new feature
|
|
156
|
+
[ ] Rollback plan documented and verified
|
|
157
|
+
[ ] No error spike in first 30 minutes post-deploy
|
|
158
|
+
[ ] SESSION_SNAPSHOT/S10_production.md created
|
|
159
|
+
[ ] Git tag: v[semver] created
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
### S11 — Operate & Maintain (Day-2)
|
|
163
|
+
```
|
|
164
|
+
[ ] Observability stack live (metrics/logs/traces, dashboards, SLOs)
|
|
165
|
+
[ ] Runbooks authored per service (RUNBOOK_TEMPLATE.md)
|
|
166
|
+
[ ] On-call rotation + error-budget policy defined
|
|
167
|
+
[ ] Dependency/patch cadence running; 0 open critical CVEs
|
|
168
|
+
[ ] SLO adherence report green; cost within budget
|
|
169
|
+
[ ] SESSION_SNAPSHOT/S11_operate.md created
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
### S12 — Evolve & Improve (Day-2)
|
|
173
|
+
```
|
|
174
|
+
[ ] Blameless retrospective held; action items logged
|
|
175
|
+
[ ] Product analytics reviewed (funnels, retention, North-Star movement)
|
|
176
|
+
[ ] A/B experiments planned and each has a decision (ship/iterate/kill)
|
|
177
|
+
[ ] Tech-debt paydown items fed back into the backlog/S04
|
|
178
|
+
[ ] DORA + SPACE metrics reviewed; stale feature flags retired
|
|
179
|
+
[ ] SESSION_SNAPSHOT/S12_evolve.md created
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
### S13 — Decommission & Sunset (Day-2)
|
|
183
|
+
```
|
|
184
|
+
[ ] Deprecation policy + timeline approved
|
|
185
|
+
[ ] Data retention/migration executed; archives + final backups taken
|
|
186
|
+
[ ] Users notified; migration paths communicated
|
|
187
|
+
[ ] Infra torn down safely; no live dependents remain
|
|
188
|
+
[ ] License/contract/vendor wind-down confirmed
|
|
189
|
+
[ ] SESSION_SNAPSHOT/S13_sunset.md created
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
---
|
|
193
|
+
|
|
194
|
+
## Current Blockers
|
|
195
|
+
|
|
196
|
+
| Blocker | Since | Waiting for | Owner |
|
|
197
|
+
|---|---|---|---|
|
|
198
|
+
| [description] | [date] | [decision/person/event] | [name] |
|
|
199
|
+
|
|
200
|
+
---
|
|
201
|
+
|
|
202
|
+
## Upcoming Milestones
|
|
203
|
+
|
|
204
|
+
| Milestone | Target Date | Dependencies |
|
|
205
|
+
|---|---|---|
|
|
206
|
+
| PRD approved (S01) | [date] | Stakeholder availability |
|
|
207
|
+
| Ready to code (S04) | [date] | S01+S02+S03 complete |
|
|
208
|
+
| Feature complete (S05) | [date] | All tasks |
|
|
209
|
+
| Production deploy (S10) | [date] | S06-S09 gates |
|
|
210
|
+
|
|
211
|
+
---
|
|
212
|
+
|
|
213
|
+
## History
|
|
214
|
+
|
|
215
|
+
| Date | Phase | Event | By |
|
|
216
|
+
|---|---|---|---|
|
|
217
|
+
| [date] | S00 | Kit initialized | setup-context.sh |
|
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
# Session Snapshot — S[XX]_[PHASE_NAME]
|
|
2
|
+
<!-- Created by: sdlc-checkpoint.skill -->
|
|
3
|
+
<!-- Store in: agents/memory/episodic/SESSION_SNAPSHOT/S[XX]_[phase].md -->
|
|
4
|
+
<!-- IMMUTABLE after creation — never overwrite, create new snapshot for revisions -->
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
**Snapshot ID:** S[XX]-[YYYYMMDD]-[HH]
|
|
9
|
+
**Timestamp:** [ISO 8601: 2025-03-15T14:30:00Z]
|
|
10
|
+
**SDLC Phase:** S[XX] — [Phase Name: REQUIREMENTS/DESIGN/SPEC/TASKS/IMPLEMENTATION/TESTING/SECURITY/REVIEW/STAGING/PRODUCTION]
|
|
11
|
+
**Created by:** [agent persona name or "human"]
|
|
12
|
+
**Project:** [Project name from AGENTS.md]
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## 1. Current Project State
|
|
17
|
+
|
|
18
|
+
```
|
|
19
|
+
SDLC Phase: S[XX] — [Phase Name]
|
|
20
|
+
Phase status: COMPLETED / IN_PROGRESS
|
|
21
|
+
Gate criteria met: YES / NO (if NO, explain)
|
|
22
|
+
Overall progress: [X]/10 phases complete
|
|
23
|
+
Confidence: HIGH / MEDIUM / LOW
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## 2. What Was Decided / Built This Phase
|
|
29
|
+
|
|
30
|
+
<!-- Summary of the key work done since the last snapshot -->
|
|
31
|
+
|
|
32
|
+
**Key decisions:**
|
|
33
|
+
- [Decision 1: e.g., "Chose Prisma as ORM — see ADR-003"]
|
|
34
|
+
- [Decision 2: e.g., "Deferred multi-currency support to v2 — PRD updated"]
|
|
35
|
+
|
|
36
|
+
**Key artifacts produced:**
|
|
37
|
+
- [Artifact 1: e.g., "PRD.md with 12 EARS requirements — human approved 2025-03-15"]
|
|
38
|
+
- [Artifact 2: e.g., "PLAN.md with 5 implementation phases"]
|
|
39
|
+
- [Artifact 3: e.g., "ADR-001 to ADR-003 in docs/architecture/decisions/"]
|
|
40
|
+
|
|
41
|
+
**Key code changes:**
|
|
42
|
+
- [e.g., "Implemented CreateUserUseCase — all 8 unit tests passing"]
|
|
43
|
+
- [e.g., "Database migration: added users table + email_verified_at column"]
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## 3. Artifact Status
|
|
48
|
+
|
|
49
|
+
| Artifact | Status | Location | Notes |
|
|
50
|
+
|---|---|---|---|
|
|
51
|
+
| PRD.md | exists / MISSING | docs/PRD.md | Human approved [date] |
|
|
52
|
+
| SPEC.md | exists / MISSING | docs/SPEC.md | — |
|
|
53
|
+
| PLAN.md | exists / MISSING | docs/PLAN.md | — |
|
|
54
|
+
| project/TASKS.md | [N/M tasks done] | project/TASKS.md | [N] TODO, [N] IN_PROGRESS, [N] DONE, [N] BLOCKED |
|
|
55
|
+
| ADRs | [N] created | docs/architecture/decisions/ | Latest: ADR-[NNN] |
|
|
56
|
+
| Threat models | [N] created | docs/security/threat-models/ | — |
|
|
57
|
+
| OpenAPI spec | exists / MISSING | docs/api/openapi.yaml | — |
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## 4. Test Status
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
Last run: [ISO datetime or "never"]
|
|
65
|
+
Pass: [N]
|
|
66
|
+
Fail: [0] (must be 0 at checkpoint)
|
|
67
|
+
Skip: [0] (or documented reason for each skip)
|
|
68
|
+
Coverage: [X]% (must be >= 99% at S06+)
|
|
69
|
+
|
|
70
|
+
Flaky tests: [none / list any known flaky tests]
|
|
71
|
+
Last test cmd: [exact command run]
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## 5. Quality Gate Status
|
|
77
|
+
|
|
78
|
+
| Gate | Status | Last Run | Score/Notes |
|
|
79
|
+
|---|---|---|---|
|
|
80
|
+
| Gate 1: Lint | PASS/FAIL | [date] | [0 errors] |
|
|
81
|
+
| Gate 2: Typecheck | PASS/FAIL | [date] | [0 errors] |
|
|
82
|
+
| Gate 3: Coverage | PASS/FAIL | [date] | [X]% |
|
|
83
|
+
| Gate 4: Integration | PASS/FAIL | [date] | [N] endpoints tested] |
|
|
84
|
+
| Gate 5: Security scan | PASS/FAIL | [date] | [0 critical CVEs] |
|
|
85
|
+
| Gate 6: Complexity | PASS/FAIL | [date] | [max complexity: X] |
|
|
86
|
+
| Gate 7: EARS compliance | PASS/FAIL | [date] | [N/M requirements covered] |
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## 6. Security Status
|
|
91
|
+
|
|
92
|
+
```
|
|
93
|
+
Last security audit: [date or "not run"]
|
|
94
|
+
Open CVEs (critical): [0]
|
|
95
|
+
Open CVEs (high): [0]
|
|
96
|
+
SECURITY_CHECKLIST: [X]% complete
|
|
97
|
+
Threat models created: [N]
|
|
98
|
+
Last gitleaks scan: [date] — CLEAN / ISSUES FOUND
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## 7. Architecture Status
|
|
104
|
+
|
|
105
|
+
```
|
|
106
|
+
Last agentic-linter run: [date or "not run"]
|
|
107
|
+
Architecture violations: [0] (must be 0 at S06+)
|
|
108
|
+
Circular dependencies: [0]
|
|
109
|
+
ADRs for decisions: ALL / [N missing]
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## 8. Open Issues & Known Debt
|
|
115
|
+
|
|
116
|
+
**Blocked tasks:**
|
|
117
|
+
- [Task ID]: [reason it's blocked]
|
|
118
|
+
|
|
119
|
+
**Pending human decisions:**
|
|
120
|
+
- [Question 1: e.g., "Should we support SSO in v1 or defer to v2?"]
|
|
121
|
+
|
|
122
|
+
**Known bugs (not blocking):**
|
|
123
|
+
- [Bug 1: file.ts:42 — non-critical edge case]
|
|
124
|
+
|
|
125
|
+
**Tech debt backlog size:** [N items] — see TECH_DEBT_TEMPLATE.md
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## 9. Memory Pointers
|
|
130
|
+
|
|
131
|
+
<!-- Help the next session quickly find key context -->
|
|
132
|
+
|
|
133
|
+
**Key ADRs to read:**
|
|
134
|
+
- ADR-[NNN]: [topic — link]
|
|
135
|
+
|
|
136
|
+
**Key CONTINUITY.md entries relevant to next phase:**
|
|
137
|
+
- [Any past failures that the next phase should be aware of]
|
|
138
|
+
|
|
139
|
+
**Semantic knowledge to load:**
|
|
140
|
+
- [Key facts in agents/memory/semantic/ relevant to continuing work]
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
## 10. Next Actions
|
|
145
|
+
|
|
146
|
+
<!-- Ordered list of what needs to happen next to advance the project -->
|
|
147
|
+
|
|
148
|
+
1. [First thing to do in the next session]
|
|
149
|
+
2. [Second thing]
|
|
150
|
+
3. [Third thing]
|
|
151
|
+
|
|
152
|
+
**Next phase entry criteria:**
|
|
153
|
+
- [ ] [What must be true to start Phase S[XX+1]]
|
|
154
|
+
- [ ] [Human approval received for: X]
|
|
155
|
+
|
|
156
|
+
---
|
|
157
|
+
|
|
158
|
+
## 11. Gate Criteria — Verified This Checkpoint
|
|
159
|
+
|
|
160
|
+
<!-- Document what was checked and confirmed for this phase gate -->
|
|
161
|
+
|
|
162
|
+
- [x] [criterion 1 — verified]
|
|
163
|
+
- [x] [criterion 2 — verified]
|
|
164
|
+
- [ ] [criterion 3 — NOT MET (reason)]
|
|
165
|
+
|
|
166
|
+
**Gate PASSED: YES / NO**
|
|
167
|
+
|
|
168
|
+
If NO: list what must be done before this checkpoint is valid.
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Strategic System Analysis: [System Name]
|
|
2
|
+
|
|
3
|
+
## 1. The Iceberg Model
|
|
4
|
+
|
|
5
|
+
### Events (What happened?)
|
|
6
|
+
* [Event 1]
|
|
7
|
+
* [Event 2]
|
|
8
|
+
|
|
9
|
+
### Patterns (What trends are occurring?)
|
|
10
|
+
* [Trend 1]
|
|
11
|
+
* [Trend 2]
|
|
12
|
+
|
|
13
|
+
### Structures (What influences the patterns?)
|
|
14
|
+
* **Physical:** (Architecture, Network)
|
|
15
|
+
* **Process:** (CI/CD, Code Review, Sprints)
|
|
16
|
+
* **Organizational:** (Team incentives, Silos)
|
|
17
|
+
|
|
18
|
+
### Mental Models (What assumptions drive the structure?)
|
|
19
|
+
* "We must ship features fast to survive."
|
|
20
|
+
* "Testing slows us down."
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## 2. Causal Loop Analysis
|
|
25
|
+
|
|
26
|
+
**Key Variables:**
|
|
27
|
+
1. Variable A
|
|
28
|
+
2. Variable B
|
|
29
|
+
|
|
30
|
+
**Loops:**
|
|
31
|
+
|
|
32
|
+
* **Loop 1 (Reinforcing/Balancing): [Name]**
|
|
33
|
+
* A increases B
|
|
34
|
+
* B decreases C
|
|
35
|
+
* C increases A
|
|
36
|
+
* *Result:* Oscillation / Explosion
|
|
37
|
+
|
|
38
|
+
*(Insert Mermaid diagram here if possible)*
|
|
39
|
+
|
|
40
|
+
---
|
|
41
|
+
|
|
42
|
+
## 3. Leverage Points
|
|
43
|
+
|
|
44
|
+
| Intervention | Leverage (Low/Med/High) | Expected Impact |
|
|
45
|
+
|---|---|---|
|
|
46
|
+
| Change Parameter X | Low | Small stabilization |
|
|
47
|
+
| Change Feedback Loop Y | Medium | Faster correction |
|
|
48
|
+
| Change Goal of System | High | Fundamental shift |
|
|
49
|
+
|
|
50
|
+
## 4. Archetype
|
|
51
|
+
**Identified Trap:** [e.g., Fixes that Fail]
|
|
52
|
+
**Way Out:** [Strategy to break the trap]
|