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,45 @@
|
|
|
1
|
+
{
|
|
2
|
+
"_comment": "Swarm Configuration - Defines the network topology of the multi-agent system.",
|
|
3
|
+
"swarm_id": "project-alpha-swarm",
|
|
4
|
+
"topology_type": "star | mesh | hierarchical",
|
|
5
|
+
|
|
6
|
+
"orchestrator": {
|
|
7
|
+
"agent_id": "loki-planner-01",
|
|
8
|
+
"endpoint": "http://localhost:8000"
|
|
9
|
+
},
|
|
10
|
+
|
|
11
|
+
"agents": [
|
|
12
|
+
{
|
|
13
|
+
"role": "frontend-coder",
|
|
14
|
+
"agent_id": "fe-01",
|
|
15
|
+
"transport": "sse",
|
|
16
|
+
"endpoint": "http://localhost:8001/events",
|
|
17
|
+
"capabilities": ["react", "css", "jest"]
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"role": "backend-coder",
|
|
21
|
+
"agent_id": "be-01",
|
|
22
|
+
"transport": "http",
|
|
23
|
+
"endpoint": "http://localhost:8002/api",
|
|
24
|
+
"capabilities": ["node", "sql", "api"]
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"role": "security-audit",
|
|
28
|
+
"agent_id": "sec-01",
|
|
29
|
+
"transport": "stdio",
|
|
30
|
+
"command": "python3 agents/security_agent.py",
|
|
31
|
+
"capabilities": ["sast", "audit"]
|
|
32
|
+
}
|
|
33
|
+
],
|
|
34
|
+
|
|
35
|
+
"channels": {
|
|
36
|
+
"broadcast": "redis://localhost:6379/broadcast",
|
|
37
|
+
"tasks": "amqp://guest:guest@localhost:5672/tasks"
|
|
38
|
+
},
|
|
39
|
+
|
|
40
|
+
"policies": {
|
|
41
|
+
"max_hops": 5,
|
|
42
|
+
"timeout_ms": 30000,
|
|
43
|
+
"retry_count": 3
|
|
44
|
+
}
|
|
45
|
+
}
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
# AUDIT_LOG.md — Project Audit Trail
|
|
2
|
+
<!-- APPEND ONLY — never delete or modify existing entries -->
|
|
3
|
+
<!-- Updated by: audit-trail.skill | Read by: session-resume.skill, integrity-check.skill -->
|
|
4
|
+
<!-- Project: [Project Name] | Started: [date] | Format version: 1.0 -->
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Log Format
|
|
9
|
+
|
|
10
|
+
```
|
|
11
|
+
| Timestamp (ISO 8601) | Session ID | Agent/Human | Action Type | Description | Outcome | References |
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
**Session ID format:** `S[SDLC-phase]-[sequential-number]` (e.g., `S01-001`, `S05-023`)
|
|
15
|
+
|
|
16
|
+
**Action Types:**
|
|
17
|
+
| Type | When to use |
|
|
18
|
+
|---|---|
|
|
19
|
+
| `DECISION` | A choice was made between options |
|
|
20
|
+
| `PHASE_TRANSITION` | SDLC phase changed (sdlc-checkpoint.skill) |
|
|
21
|
+
| `TASK_DONE` | A task completed successfully |
|
|
22
|
+
| `TASK_BLOCKED` | A task is stuck, human decision needed |
|
|
23
|
+
| `QUALITY_GATE` | Quality gate pass/fail result |
|
|
24
|
+
| `SECURITY_FINDING` | Security issue found (include severity) |
|
|
25
|
+
| `ADR_CREATED` | Architecture decision documented |
|
|
26
|
+
| `HUMAN_ESCALATION` | Agent escalated to human (5 attempts exhausted) |
|
|
27
|
+
| `SELF_HEAL_ATTEMPT` | Agent tried to self-fix (include attempt N/5) |
|
|
28
|
+
| `RESEARCH_FINDING` | Authoritative source verified |
|
|
29
|
+
| `HUMAN_APPROVED` | Human provided approval/decision |
|
|
30
|
+
| `ERROR` | Unexpected error encountered |
|
|
31
|
+
| `ROLLBACK` | A change was reverted |
|
|
32
|
+
|
|
33
|
+
**Outcome values:** `SUCCESS` | `FAIL` | `PASS` | `OPEN` | `RESOLVED` | `APPROVED` | `REJECTED` | `ESCALATED`
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Instructions for Agents
|
|
38
|
+
|
|
39
|
+
1. **Append a new row** for every significant action (do NOT edit existing rows)
|
|
40
|
+
2. **Do NOT overwrite** this file — always append
|
|
41
|
+
3. **Reference artifacts** by path or URL in the References column
|
|
42
|
+
4. **Be specific** in Description — "fixed auth bug" is bad; "removed missing null check on user.email in UserService.update() line 42" is good
|
|
43
|
+
5. For HUMAN_ESCALATION: add a note row below the entry with the escalation report summary
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## Log Entries
|
|
48
|
+
|
|
49
|
+
| Timestamp | Session | Agent/Human | Action Type | Description | Outcome | References |
|
|
50
|
+
|---|---|---|---|---|---|---|
|
|
51
|
+
| [INIT] | S00-001 | setup-context.sh | PHASE_TRANSITION | agents/ kit initialized for project | SUCCESS | agents/README_FULL.md |
|
|
52
|
+
|
|
53
|
+
<!--
|
|
54
|
+
EXAMPLE ENTRIES (remove this comment block when using):
|
|
55
|
+
|
|
56
|
+
| 2025-03-15T09:00:00Z | S01-001 | prod-pm | DECISION | Chose EARS format for requirements over user story format | SUCCESS | docs/PRD.md |
|
|
57
|
+
| 2025-03-15T09:30:00Z | S01-001 | prod-pm | PHASE_TRANSITION | PRD.md completed — awaiting human approval for S01 | OPEN | docs/PRD.md |
|
|
58
|
+
| 2025-03-15T10:00:00Z | S01-001 | human:alice | HUMAN_APPROVED | PRD.md approved — 12 EARS requirements signed off | APPROVED | docs/PRD.md |
|
|
59
|
+
| 2025-03-15T10:01:00Z | S01-001 | sdlc-checkpoint | PHASE_TRANSITION | S01 Requirements checkpoint created | SUCCESS | agents/memory/episodic/SESSION_SNAPSHOT/S01_requirements.md |
|
|
60
|
+
| 2025-03-15T11:00:00Z | S02-001 | prod-architect | ADR_CREATED | Chose Prisma over TypeORM — performance + type safety | ACCEPTED | docs/architecture/decisions/ADR-001-prisma.md |
|
|
61
|
+
| 2025-03-15T11:30:00Z | S02-001 | prod-architect | DECISION | Chose Clean Architecture — domain/application/adapters/infra/main | ACCEPTED | docs/PLAN.md |
|
|
62
|
+
| 2025-03-15T14:00:00Z | S05-001 | eng-backend | TASK_DONE | T-001: Created User domain entity with email value object | SUCCESS | src/domain/user.ts |
|
|
63
|
+
| 2025-03-15T14:30:00Z | S05-001 | eng-backend | SELF_HEAL_ATTEMPT | T-002: TypeScript error on UserDto.email — attempt 1/5 — null check missing | FAIL | src/application/create-user.use-case.ts:42 |
|
|
64
|
+
| 2025-03-15T14:35:00Z | S05-001 | eng-backend | TASK_DONE | T-002: Fixed type error — added null guard before email access | SUCCESS | src/application/create-user.use-case.ts |
|
|
65
|
+
| 2025-03-15T16:00:00Z | S05-001 | eng-backend | TASK_BLOCKED | T-020: Cannot implement payment integration — unclear if Stripe or Paddle | OPEN | project/TASKS.md |
|
|
66
|
+
| 2025-03-15T16:01:00Z | S05-001 | eng-backend | HUMAN_ESCALATION | T-020 blocked: Payment provider not decided. Options: Stripe (fees: 2.9%) vs Paddle (fees: 5%). Recommend Stripe (direct settlement). | ESCALATED | project/TASKS.md |
|
|
67
|
+
| 2025-03-15T16:45:00Z | S05-001 | human:bob | DECISION | Use Stripe for payment processing — direct settlement preferred | APPROVED | — |
|
|
68
|
+
| 2025-03-15T17:00:00Z | S06-001 | orch-judge | QUALITY_GATE | Gate 3 Tests: 247 pass, 0 fail, 0 skip, 84% coverage | PASS | — |
|
|
69
|
+
| 2025-03-15T17:05:00Z | S07-001 | ops-security | SECURITY_FINDING | HIGH: No rate limit on /auth/login endpoint — brute force possible | OPEN | src/adapters/http/auth.controller.ts:23 |
|
|
70
|
+
| 2025-03-15T17:30:00Z | S07-001 | eng-backend | TASK_DONE | Added rate limiting to /auth/login: 5 req/min per IP | SUCCESS | src/adapters/http/auth.controller.ts |
|
|
71
|
+
| 2025-03-15T17:31:00Z | S07-001 | ops-security | SECURITY_FINDING | HIGH: No rate limit on /auth/login — RESOLVED | RESOLVED | src/adapters/http/auth.controller.ts |
|
|
72
|
+
| 2025-03-15T18:00:00Z | S08-001 | human:alice | HUMAN_APPROVED | Code review approved — all feedback addressed | APPROVED | PR #42 |
|
|
73
|
+
| 2025-03-15T18:01:00Z | S10-001 | sdlc-checkpoint | PHASE_TRANSITION | S10 Production deployed. Project complete | SUCCESS | agents/memory/episodic/SESSION_SNAPSHOT/S10_production.md |
|
|
74
|
+
|
|
75
|
+
END EXAMPLES -->
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
# Bug Report: [Brief Title]
|
|
2
|
+
<!-- Fill before using debug.skill — helps agent understand and reproduce the bug -->
|
|
3
|
+
<!-- Created: [date] | Reported by: [name] -->
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Summary
|
|
8
|
+
|
|
9
|
+
**One-line description:** [What is broken in plain language]
|
|
10
|
+
|
|
11
|
+
**Severity:** Critical | High | Medium | Low
|
|
12
|
+
|
|
13
|
+
**Impact:** [Who is affected, how often, what the business impact is]
|
|
14
|
+
|
|
15
|
+
**Environment:**
|
|
16
|
+
```
|
|
17
|
+
OS: [Linux / macOS / Windows + version]
|
|
18
|
+
Browser: [Chrome 120 / Firefox 121 / N/A]
|
|
19
|
+
Node/PHP/etc: [runtime version]
|
|
20
|
+
App version: [git commit hash or release tag]
|
|
21
|
+
Database: [PostgreSQL 16 / MySQL 8 / etc]
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## Steps to Reproduce
|
|
27
|
+
|
|
28
|
+
<!-- Be specific — a bug that can't be reproduced can't be fixed -->
|
|
29
|
+
|
|
30
|
+
1. [Starting state: "Given a user is logged in as role X"]
|
|
31
|
+
2. [Action: "When they navigate to /settings/profile"]
|
|
32
|
+
3. [Action: "And they click 'Save Changes' without modifying any field"]
|
|
33
|
+
4. [Observed: "Then they see a 500 Internal Server Error"]
|
|
34
|
+
|
|
35
|
+
**Minimum reproduction:** [The fewest steps to see the bug]
|
|
36
|
+
|
|
37
|
+
**Is it reproducible?** [Always / Intermittently (estimate %) / Rare / Only once]
|
|
38
|
+
|
|
39
|
+
**Reproduction rate (if intermittent):** [Approximately X out of Y tries]
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## Expected Behavior
|
|
44
|
+
|
|
45
|
+
[What should have happened? Be specific.]
|
|
46
|
+
|
|
47
|
+
Example: "Clicking 'Save Changes' with unchanged data should return 200 OK and display 'No changes saved' message."
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## Actual Behavior
|
|
52
|
+
|
|
53
|
+
[What actually happens? Include exact error messages, HTTP status codes, UI state.]
|
|
54
|
+
|
|
55
|
+
Example: "API returns HTTP 500 with body: `{ "error": "Cannot read properties of undefined (reading 'email')" }`"
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## Error Messages & Stack Trace
|
|
60
|
+
|
|
61
|
+
```
|
|
62
|
+
[Paste full error message and stack trace here]
|
|
63
|
+
|
|
64
|
+
Example:
|
|
65
|
+
TypeError: Cannot read properties of undefined (reading 'email')
|
|
66
|
+
at UserController.update (/app/src/adapters/http/user.controller.ts:45:22)
|
|
67
|
+
at Layer.handle [as handle_request] (/app/node_modules/express/lib/router/layer.js:95:5)
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## Logs
|
|
73
|
+
|
|
74
|
+
```
|
|
75
|
+
[Relevant log lines from application or server logs]
|
|
76
|
+
[Include timestamps if available]
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
## Screenshots / Videos
|
|
82
|
+
|
|
83
|
+
[If UI bug: link to screenshot or screen recording]
|
|
84
|
+
[If API bug: include request/response from browser DevTools or Postman]
|
|
85
|
+
|
|
86
|
+
**API Request:**
|
|
87
|
+
```
|
|
88
|
+
POST /api/v1/users/123 HTTP/1.1
|
|
89
|
+
Authorization: Bearer [token]
|
|
90
|
+
Content-Type: application/json
|
|
91
|
+
|
|
92
|
+
{}
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
**API Response:**
|
|
96
|
+
```
|
|
97
|
+
HTTP/1.1 500 Internal Server Error
|
|
98
|
+
Content-Type: application/json
|
|
99
|
+
|
|
100
|
+
{ "error": "Internal server error" }
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
## Hypothesis (Initial Guess)
|
|
106
|
+
|
|
107
|
+
[Your initial hypothesis about what's causing the bug — even if uncertain]
|
|
108
|
+
|
|
109
|
+
Example: "Suspect the save handler doesn't check for empty body before accessing `body.email`"
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## Context
|
|
114
|
+
|
|
115
|
+
**Related code:** [file path and line number if known]
|
|
116
|
+
**Related PR/commit:** [link if you know when this was introduced]
|
|
117
|
+
**Regression?** [Did this work before? When did it stop working?]
|
|
118
|
+
**Workaround?** [Is there a temporary workaround users can use?]
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## Definition of Fixed
|
|
123
|
+
|
|
124
|
+
<!-- What exact behavior will confirm this bug is resolved? -->
|
|
125
|
+
|
|
126
|
+
- [ ] [Specific test that must pass]
|
|
127
|
+
- [ ] [Specific behavior that must work]
|
|
128
|
+
- [ ] [No regressions in related functionality]
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## Assignment
|
|
133
|
+
|
|
134
|
+
**Assigned to:** [agent / human developer]
|
|
135
|
+
**Priority:** [P1 (immediate) / P2 (this sprint) / P3 (backlog)]
|
|
136
|
+
**Labels:** [ui, api, database, performance, security]
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# Dependency & Parallelism Worksheet: [Project / Milestone Name]
|
|
2
|
+
|
|
3
|
+
**Date:** [YYYY-MM-DD]
|
|
4
|
+
**Author:** [name]
|
|
5
|
+
**Status:** Draft | Reviewed
|
|
6
|
+
|
|
7
|
+
<!-- Goal: find what can run in parallel, what's on the critical path, and where
|
|
8
|
+
resources collide. This drives scheduling and staffing decisions. -->
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## 1. Task Dependency Table
|
|
13
|
+
|
|
14
|
+
| Task | Depends on | Blocks | Can parallelize with | Resource conflicts |
|
|
15
|
+
|---|---|---|---|---|
|
|
16
|
+
| [T1: name] | [—] | [T3, T4] | [T2] | [None] |
|
|
17
|
+
| [T2: name] | [—] | [T4] | [T1] | [Shares DB migration window with T5] |
|
|
18
|
+
| [T3: name] | [T1] | [ ] | [ ] | [ ] |
|
|
19
|
+
| [T4: name] | [T1, T2] | [ ] | [ ] | [ ] |
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## 2. Critical Path
|
|
24
|
+
|
|
25
|
+
<!-- The longest chain of dependent tasks. Its length is the floor on project
|
|
26
|
+
duration — shortening anything OFF this path does not help. -->
|
|
27
|
+
|
|
28
|
+
**Path:** [T1 → T4 → ... → done]
|
|
29
|
+
**Estimated length:** [sum of durations along the path]
|
|
30
|
+
**Slack elsewhere:** [Tasks with float and how much, e.g. "T2 has 2d slack."]
|
|
31
|
+
**Biggest risk on the path:** [Which task, and why.]
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 3. Dependency DAG
|
|
36
|
+
|
|
37
|
+
<!-- Replace with a real graph. Mermaid or plain arrows both fine. -->
|
|
38
|
+
|
|
39
|
+
```mermaid
|
|
40
|
+
graph LR
|
|
41
|
+
T1[T1: name] --> T3[T3: name]
|
|
42
|
+
T1 --> T4[T4: name]
|
|
43
|
+
T2[T2: name] --> T4
|
|
44
|
+
T4 --> DONE[Done]
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Plain-text fallback:
|
|
48
|
+
```
|
|
49
|
+
T1 ─┬─> T3
|
|
50
|
+
└─> T4 ──> DONE
|
|
51
|
+
T2 ─────> T4
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## 4. Parallelization Plan
|
|
57
|
+
|
|
58
|
+
| Wave | Tasks runnable together | Owner(s) | Gate to next wave |
|
|
59
|
+
|---|---|---|---|
|
|
60
|
+
| 1 | [T1, T2] | [ ] | [Both complete] |
|
|
61
|
+
| 2 | [T3, T4] | [ ] | [ ] |
|
|
62
|
+
|
|
63
|
+
**Resource bottlenecks:** [Shared people, environments, or services that cap actual parallelism below the theoretical max.]
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
# Estimation Worksheet: [Project / Feature Name]
|
|
2
|
+
|
|
3
|
+
**Date:** [YYYY-MM-DD]
|
|
4
|
+
**Estimator(s):** [names or roles]
|
|
5
|
+
**Status:** Draft | Reviewed | Final
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 1. Scope
|
|
10
|
+
|
|
11
|
+
**In scope:** [What work is being estimated? e.g., "Backend API + DB migration for the new billing module".]
|
|
12
|
+
**Out of scope:** [What is explicitly NOT included? e.g., "Frontend UI, third-party tax integration".]
|
|
13
|
+
**Assumptions baked into this estimate:** [List the load-bearing assumptions; if one breaks, the estimate breaks.]
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 2. Method
|
|
18
|
+
|
|
19
|
+
Pick one (or combine) and justify:
|
|
20
|
+
|
|
21
|
+
| Method | When to use | Selected? |
|
|
22
|
+
|---|---|---|
|
|
23
|
+
| Reference-class forecasting | Similar past projects exist to anchor against | [Yes/No] |
|
|
24
|
+
| Story points (relative) | Team has a stable velocity baseline | [Yes/No] |
|
|
25
|
+
| T-shirt sizing (XS–XL) | Early/coarse; no detailed breakdown yet | [Yes/No] |
|
|
26
|
+
|
|
27
|
+
**Justification:** [Why this method fits the current uncertainty and available data.]
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## 3. Per-Item Estimates
|
|
32
|
+
|
|
33
|
+
P50 = "as likely to finish before as after." P90 = "90% chance we finish by this." The P90/P50 gap is the risk premium.
|
|
34
|
+
|
|
35
|
+
| Item | Size | P50 | P90 | Confidence | Assumptions |
|
|
36
|
+
|---|---|---|---|---|---|
|
|
37
|
+
| [Task / story] | [XS–XL or pts] | [e.g. 2d] | [e.g. 5d] | [Low/Med/High] | [Key assumption] |
|
|
38
|
+
| [Task / story] | [ ] | [ ] | [ ] | [ ] | [ ] |
|
|
39
|
+
| [Task / story] | [ ] | [ ] | [ ] | [ ] | [ ] |
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## 4. Cone of Uncertainty
|
|
44
|
+
|
|
45
|
+
<!-- Early estimates can be off by 4x in either direction; the range narrows only as work is done.
|
|
46
|
+
Record WHERE on the cone this estimate sits so readers calibrate trust. -->
|
|
47
|
+
|
|
48
|
+
**Phase:** [Concept / Requirements-set / Design-complete / In-progress]
|
|
49
|
+
**Expected error band at this phase:** [e.g. "0.5x to 2x" early; "0.8x to 1.25x" mid-flight]
|
|
50
|
+
**What would tighten the cone:** [Spikes, prototypes, or decisions that would reduce uncertainty.]
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## 5. Total Range
|
|
55
|
+
|
|
56
|
+
| Roll-up | Optimistic (sum P50) | Realistic (P90-weighted) | Pessimistic (sum P90) |
|
|
57
|
+
|---|---|---|---|
|
|
58
|
+
| Effort | [ ] | [ ] | [ ] |
|
|
59
|
+
| Calendar (with WIP/parallelism) | [ ] | [ ] | [ ] |
|
|
60
|
+
|
|
61
|
+
**Stated range:** [e.g. "3–6 weeks, most likely 4."]
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
## 6. Honesty Note
|
|
66
|
+
|
|
67
|
+
> An estimate is a probability range, not a commitment or a deadline.
|
|
68
|
+
> Reporting a single number hides the risk. Always present the range and the
|
|
69
|
+
> confidence behind it. If a date is needed, derive it from the P90 plus an
|
|
70
|
+
> explicit buffer — and say so out loud.
|