agent-toolkit-cli 1.0.3__py3-none-any.whl
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.
- agent_toolkit/__init__.py +4 -0
- agent_toolkit/__main__.py +3 -0
- agent_toolkit/_paths.py +64 -0
- agent_toolkit/cli/__init__.py +0 -0
- agent_toolkit/cli/doctor.py +453 -0
- agent_toolkit/cli/install.py +445 -0
- agent_toolkit/cli/main.py +66 -0
- agent_toolkit/cli/mcp.py +418 -0
- agent_toolkit/cli/plugin.py +213 -0
- agent_toolkit/cli/skills.py +421 -0
- agent_toolkit/loop/__init__.py +0 -0
- agent_toolkit/loop/gh_gate.py +626 -0
- agent_toolkit/loop/runner.py +1548 -0
- agent_toolkit/runner/__init__.py +0 -0
- agent_toolkit/runner/dispatcher.py +164 -0
- agent_toolkit/runner/policy.py +345 -0
- agent_toolkit/runner/providers/__init__.py +21 -0
- agent_toolkit/runner/providers/anthropic_provider.py +109 -0
- agent_toolkit/runner/providers/base.py +53 -0
- agent_toolkit/runner/providers/ollama_provider.py +108 -0
- agent_toolkit/runner/providers/openai_provider.py +105 -0
- agent_toolkit/runner/providers/opencode_provider.py +127 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/architect/AGENT.md +30 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/assistant/AGENT.md +59 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/build-error-resolver/AGENT.md +30 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/client-workflow-bootstrap/AGENT.md +60 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/code-reviewer/AGENT.md +49 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/database-reviewer/AGENT.md +44 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/docs-lookup/AGENT.md +28 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/e2e-runner/AGENT.md +38 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/performance-optimizer/AGENT.md +52 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/planner/AGENT.md +41 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/refactor-cleaner/AGENT.md +43 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/reference-lookup/AGENT.md +33 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/security-reviewer/AGENT.md +47 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/tdd-guide/AGENT.md +58 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/tech-assistant/AGENT.md +11 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/agents/typescript-reviewer/AGENT.md +61 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/catalogs/agent-catalog.yaml +202 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/catalogs/loop-catalog.yaml +165 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/catalogs/skill-catalog.yaml +699 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/catalogs/skills-layout.json +337 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/changelog-drafter/loop.yaml +40 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/ci-sweeper/loop.yaml +53 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/daily-triage/loop.yaml +47 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/dep-sweeper/loop.yaml +46 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/issue-triage/loop.yaml +40 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/oss-daily-briefing/loop.yaml +65 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/oss-pr-monitor/loop.yaml +85 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/oss-triage/loop.yaml +67 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/post-merge-cleanup/loop.yaml +44 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/loops/pr-babysitter/loop.yaml +46 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/clickup/README.md +45 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/clickup/config.template.json +7 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/clickup/wrapper.sh +23 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/figma/README.md +56 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/figma/config.template.json +9 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/github/README.md +11 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/github/config.template.json +7 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/github/wrapper.sh +23 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/linear/README.md +49 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/linear/config.template.json +10 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/notion/README.md +7 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/notion/config.template.json +7 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/notion/wrapper.sh +23 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/slack/README.md +8 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/slack/config.template.json +8 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/mcp/templates/slack/wrapper.sh +23 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/CLAUDE.md +66 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/assistant.md +59 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/build-error-resolver.md +30 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/client-workflow-bootstrap.md +60 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/contribution-planner.md +39 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/database-reviewer.md +44 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/docs-lookup.md +28 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/e2e-runner.md +38 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/performance-optimizer.md +52 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/planner.md +41 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/refactor-cleaner.md +43 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/reference-lookup.md +33 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/security-reviewer.md +47 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/tdd-guide.md +58 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/agents/typescript-reviewer.md +61 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/claude-code/settings.json +87 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/copilot/copilot-instructions.md +15 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/README.md +33 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/architect.mdc +23 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/assistant.mdc +25 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/build-error-resolver.mdc +20 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/code-reviewer.mdc +21 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/database-reviewer.mdc +29 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/docs-lookup.mdc +15 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/e2e-runner.mdc +30 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/performance-optimizer.mdc +27 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/planner.mdc +28 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/refactor-cleaner.mdc +26 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/reference-lookup.mdc +20 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/security-reviewer.mdc +20 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/tdd-guide.mdc +26 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/cursor/rules/typescript-reviewer.mdc +28 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/architect.md +30 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/assistant.md +52 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/build-error-resolver.md +31 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/client-workflow-bootstrap.md +66 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/code-reviewer.md +47 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/contribution-planner.md +44 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/database-reviewer.md +43 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/docs-lookup.md +28 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/e2e-runner.md +33 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/performance-optimizer.md +34 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/planner.md +27 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/refactor-cleaner.md +27 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/reference-lookup.md +27 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/security-reviewer.md +27 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/tdd-guide.md +27 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/agents/typescript-reviewer.md +30 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/opencode/opencode.json +37 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/pi/skills/architect/skill.md +5 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/pi/skills/assistant/skill.md +3 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/pi/skills/code-reviewer/skill.md +5 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/pi/skills/planner/skill.md +3 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/pi/skills/security-reviewer/skill.md +3 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/memories/global_rules.md +74 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/architect.mdc +23 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/build-error-resolver.mdc +20 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/code-reviewer.mdc +21 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/database-reviewer.mdc +29 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/docs-lookup.mdc +15 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/e2e-runner.mdc +30 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/performance-optimizer.mdc +27 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/planner.mdc +28 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/refactor-cleaner.mdc +26 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/security-reviewer.mdc +20 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/tdd-guide.mdc +26 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/profiles/windsurf/rules/typescript-reviewer.mdc +28 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/assistant/SKILL.md +213 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/assistant/references/AGENTS_TEMPLATE.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/assistant/references/ORCHESTRATION.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/assistant/references/REPO_INSPECTION.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/dev-companion/SKILL.md +65 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/dev-companion/references/LOOP_GUARDRAILS.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/onboarding/SKILL.md +119 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/output-handshake/SKILL.md +24 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/pr-fallback/SKILL.md +33 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/pr-fallback/references/pr-body-default.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/workspace-knowledge-sync/SKILL.md +141 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/data/dbt-validation/SKILL.md +41 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/data/snowflake-validation/SKILL.md +38 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/adr/SKILL.md +46 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/adr/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/adr/references/example-001-graphql-adoption.md +66 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/agreement/SKILL.md +23 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/agreement/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/agreement/references/example-api-versioning.md +29 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/bug/SKILL.md +25 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/bug/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/bug/references/example-search-filter-bug.md +58 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/decision-log/SKILL.md +27 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/decision-log/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/decision-log/references/example-repository-pattern.md +27 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/development-workflow/SKILL.md +33 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/development-workflow/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/development-workflow/references/default-workflow-checklist.md +44 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/epic/SKILL.md +21 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/epic/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/epic/references/example-unified-dashboard.md +40 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/incident/SKILL.md +23 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/incident/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/incident/references/example-payment-outage.md +62 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/management-unit-assessment/SKILL.md +105 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/management-unit-assessment/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/management-unit-assessment/references/example-team-assessment.md +126 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/meeting-minutes/SKILL.md +24 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/meeting-minutes/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/meeting-minutes/references/example-weekly-sync.md +72 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/planning/SKILL.md +30 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/planning/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/planning/references/example-sprint-planning.md +62 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/prd/SKILL.md +44 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/prd/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/prd/references/example-unified-api.md +71 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment/SKILL.md +90 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment/references/example-platform-assessment.md +122 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment-evidence/SKILL.md +88 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment-evidence/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/project-assessment-evidence/references/example-evidence-map.md +46 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/spike/SKILL.md +23 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/spike/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/spike/references/example-graphql-federation.md +79 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/task/SKILL.md +20 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/task/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/task/references/example-nav-system.md +33 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/technical-unit-assessment/SKILL.md +58 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/technical-unit-assessment/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/technical-unit-assessment/references/example-frontend-assessment.md +112 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/technical-unit-assessment/references/indicator-groups.md +65 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/trd/SKILL.md +47 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/trd/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/trd/references/example-api-migration.md +122 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/user-story/SKILL.md +20 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/user-story/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/user-story/references/example-advanced-filtering.md +37 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/work-item/SKILL.md +30 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/work-item/references/default-template.md +0 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/work-item/references/example-routing-dashboard.md +23 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/workflow-client-bootstrap/SKILL.md +148 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/workflow-client-bootstrap/questions.yaml +165 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/delivery/workflow-generic-project/SKILL.md +78 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma/LICENSE.txt +2 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma/NOTICE.txt +25 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma/SKILL.md +95 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma/references/figma-mcp-config.md +82 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma/references/figma-tools-and-prompts.md +34 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-code-connect-components/LICENSE.txt +2 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-code-connect-components/NOTICE.txt +18 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-code-connect-components/SKILL.md +350 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-code-connect-components/references/mapping-checklist.md +7 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-code-connect-components/scripts/normalize_node_id.py +25 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-design-system-rules/LICENSE.txt +2 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-design-system-rules/NOTICE.txt +19 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-design-system-rules/SKILL.md +550 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-design-system-rules/references/rule-template.md +15 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-design-system-rules/scripts/check_agents_md.sh +9 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-new-file/LICENSE.txt +2 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-new-file/NOTICE.txt +17 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-create-new-file/SKILL.md +69 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-implement-design/LICENSE.txt +2 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-implement-design/NOTICE.txt +19 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/figma-implement-design/SKILL.md +264 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/SKILL.md +60 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/charts.csv +26 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/colors.csv +97 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/icons.csv +101 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/landing.csv +31 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/products.csv +97 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/react-performance.csv +45 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/astro.csv +54 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/react.csv +54 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/stacks/vue.csv +50 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/styles.csv +68 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/typography.csv +58 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/data/web-interface.csv +31 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/references/pre-delivery-checklist.md +39 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/references/search-reference.md +44 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/references/ui-rules.md +35 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/scripts/core.py +253 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/scripts/design_system.py +1067 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/design/ui-ux-pro-max/scripts/search.py +114 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-address-comments/LICENSE.txt +202 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-address-comments/NOTICE.txt +20 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-address-comments/SKILL.md +69 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-address-comments/scripts/fetch_comments.py +237 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-contribution-planner/SKILL.md +157 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-contribution-planner/scripts/inspect_contributions.py +800 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-fix-ci/LICENSE.txt +201 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-fix-ci/NOTICE.txt +20 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-fix-ci/SKILL.md +71 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gh-fix-ci/scripts/inspect_pr_checks.py +509 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/github-cli-workflow/SKILL.md +49 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/gitlab-cli-workflow/SKILL.md +44 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/workflow-client-bootstrap/SKILL.md +14 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/forge/workflow-generic-project/SKILL.md +14 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/clickup-cli/SKILL.md +75 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/clickup-cli/references/docs-management.md +57 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/clickup-cli/references/task-management.md +131 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/clickup-cli/references/time-tracking.md +38 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/linear/LICENSE.txt +202 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/linear/NOTICE.txt +23 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/linear/SKILL.md +131 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/slack-assistant/SKILL.md +134 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/slack-cli/SKILL.md +105 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/integrations/slack-cli/references/INSTALLATION.md +42 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/loops/loop-runner/SKILL.md +90 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/ops/docs-generator/SKILL.md +81 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/ops/llm-cost-advisor/SKILL.md +83 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/ops/triage/SKILL.md +117 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/LICENSE.txt +201 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/NOTICE.txt +27 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/SKILL.md +142 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/assets/experiment-template.ipynb +110 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/assets/tutorial-template.ipynb +107 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/references/experiment-patterns.md +10 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/references/notebook-structure.md +17 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/references/quality-checklist.md +11 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/references/tutorial-patterns.md +9 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/jupyter-notebook/scripts/new_notebook.py +130 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/LICENSE.txt +201 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/NOTICE.txt +29 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/SKILL.md +151 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/references/cli.md +116 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/references/workflows.md +98 -0
- agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/tooling/playwright-cli/scripts/executable_playwright_cli.sh +25 -0
- agent_toolkit_cli-1.0.3.dist-info/METADATA +411 -0
- agent_toolkit_cli-1.0.3.dist-info/RECORD +310 -0
- agent_toolkit_cli-1.0.3.dist-info/WHEEL +4 -0
- agent_toolkit_cli-1.0.3.dist-info/entry_points.txt +2 -0
- agent_toolkit_cli-1.0.3.dist-info/licenses/LICENSE +21 -0
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: onboarding
|
|
3
|
+
description: >-
|
|
4
|
+
Getting started guide for new users. Walks through setup validation,
|
|
5
|
+
the skill/agent hierarchy, and the three most useful commands per role (developer,
|
|
6
|
+
PM, tech lead). Use when someone is new to the workstation or asks "where do I start?"
|
|
7
|
+
metadata:
|
|
8
|
+
author: ulises-jeremias
|
|
9
|
+
version: "1.0"
|
|
10
|
+
tags: [onboarding, setup, getting-started]
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# Onboarding
|
|
14
|
+
|
|
15
|
+
Welcome to . This skill guides new users through initial setup and daily usage.
|
|
16
|
+
|
|
17
|
+
## When to use
|
|
18
|
+
|
|
19
|
+
- User asks "where do I start?" or "how does this work?"
|
|
20
|
+
- First-time setup after `chezmoi apply`
|
|
21
|
+
- Troubleshooting a broken installation
|
|
22
|
+
- Onboarding a teammate
|
|
23
|
+
|
|
24
|
+
## Step 1 — Validate setup
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
doctor
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
Expected: `result: COMPLIANT`. If any check fails, `doctor` shows the fix command.
|
|
31
|
+
|
|
32
|
+
For persistent issues:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
update-check # check for available updates
|
|
36
|
+
skills list # verify skills are installed
|
|
37
|
+
skills sync # re-sync symlinks to AI tools
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Step 2 — Understand the hierarchy
|
|
41
|
+
|
|
42
|
+
```text
|
|
43
|
+
User message
|
|
44
|
+
↓
|
|
45
|
+
Orchestrator (assistant)
|
|
46
|
+
↓ routes to
|
|
47
|
+
Workflow skill (WHAT — decides scope and gates)
|
|
48
|
+
e.g. workflow-generic-project
|
|
49
|
+
↓ delegates to
|
|
50
|
+
Tool skill (HOW — executes CLI commands)
|
|
51
|
+
e.g. clickup-cli, github-cli-workflow
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
**Skills** are invoked via the skill tool (e.g. `/planning`).
|
|
55
|
+
**Agents** are invoked via `@mention` (e.g. `@planner`). Never use the skill tool for agents.
|
|
56
|
+
|
|
57
|
+
## Step 3 — First commands by role
|
|
58
|
+
|
|
59
|
+
### Developer
|
|
60
|
+
|
|
61
|
+
```bash
|
|
62
|
+
# Start any task
|
|
63
|
+
/workflow-generic-project
|
|
64
|
+
|
|
65
|
+
# After code changes — review before PR
|
|
66
|
+
@code-reviewer
|
|
67
|
+
|
|
68
|
+
# CI failing
|
|
69
|
+
/gh-fix-ci
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### Product Manager / Tech Lead
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
# Plan a feature
|
|
76
|
+
@planner
|
|
77
|
+
|
|
78
|
+
# Create a ClickUp task
|
|
79
|
+
/clickup-cli # then: clickup task create --current --name "..."
|
|
80
|
+
|
|
81
|
+
# Project health check
|
|
82
|
+
/project-assessment
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
### Anyone
|
|
86
|
+
|
|
87
|
+
```bash
|
|
88
|
+
# Check workstation health
|
|
89
|
+
doctor
|
|
90
|
+
|
|
91
|
+
# Find which skill to use
|
|
92
|
+
# → ask the orchestrator: "what skill should I use for X?"
|
|
93
|
+
|
|
94
|
+
# Load client/project context
|
|
95
|
+
./bin/workspace-context load packs/<client>.yaml # if in ai-workspace
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
## Key concepts in 60 seconds
|
|
99
|
+
|
|
100
|
+
| Concept | What it means |
|
|
101
|
+
|---------|--------------|
|
|
102
|
+
| **Pack** | Context bundle for a client/project (repos, constraints, commands) |
|
|
103
|
+
| **Skill** | Reusable AI prompt for a specific task (WHAT or HOW) |
|
|
104
|
+
| **Agent** | Specialized AI persona with restricted tool access (invoked via @mention) |
|
|
105
|
+
| **Loop** | Recurring autonomous process with state, tiers, and cost budgets |
|
|
106
|
+
| **L1 / L2 / L3** | Loop autonomy tiers: L1=observe-only, L2=PR-gated, L3=unattended |
|
|
107
|
+
| **knowledge/** | Persistent memory across sessions |
|
|
108
|
+
|
|
109
|
+
## Anti-patterns
|
|
110
|
+
|
|
111
|
+
- Do not skip `doctor` — it catches 90% of setup issues
|
|
112
|
+
- Do not invoke agents via the skill tool — use `@mention`
|
|
113
|
+
- Do not run L3 loops without 3+ clean L1 runs first
|
|
114
|
+
|
|
115
|
+
## Next steps
|
|
116
|
+
|
|
117
|
+
- Load a project pack: `./bin/workspace-context load packs/<project>.yaml`
|
|
118
|
+
- Run your first task: `/workflow-generic-project`
|
|
119
|
+
- Set up daily loop: `./bin/loop init daily-triage`
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: output-handshake
|
|
3
|
+
description: >-
|
|
4
|
+
WHAT — Default gate for any deliverable: confirm where the final artifact will be stored and that a human will review, before writing PRDs, TRDs, ADRs, or PR bodies. Repository paths, wikis, and ticket tools differ by engagement; never assume a single location.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Output handshake (WHAT)
|
|
8
|
+
|
|
9
|
+
**Use first** when producing a **final** version of any deliverable that will leave the chat session: PRD, TRD, ADR, work item, planning notes, workflow/validation summary, project assessment, assessment scorecard, evidence map, meeting minutes, decision log, agreement, incident report, spike, or PR/MR body.
|
|
10
|
+
|
|
11
|
+
## Default behavior (always)
|
|
12
|
+
|
|
13
|
+
1. **Destination** — Ask explicitly: *where should the final content live?* (Examples: a path in `docs/`, a file in a repo, a page in a documentation tool, a task/Doc description, paste-only, or a combination.) Do **not** default to a location without the user (or the engagement pack) saying so.
|
|
14
|
+
2. **Review** — State that a **human** must review before the artifact is considered approved; the assistant does not substitute for that review.
|
|
15
|
+
3. Then proceed with the relevant skill (**`prd`**, **`trd`**, **`adr`**, **`work-item`**, **`planning`**, **`development-workflow`**, **`project-assessment`**, **`project-assessment-evidence`**, **`technical-unit-assessment`**, **`management-unit-assessment`**, **`meeting-minutes`**, **`decision-log`**, **`agreement`**, **`incident`**, **`spike`**, **`pr-fallback`** + forge workflow, etc.).
|
|
16
|
+
|
|
17
|
+
## Boundaries
|
|
18
|
+
|
|
19
|
+
- This skill does not contain org templates; those stay in the specific artifact skills and their `references/default-template.md` files.
|
|
20
|
+
|
|
21
|
+
## See also
|
|
22
|
+
|
|
23
|
+
- `workflow-generic-project` — delivery gates
|
|
24
|
+
- `assistant` — discover existing `docs/`, PR templates, `AGENTS.md`
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: pr-fallback
|
|
3
|
+
description: >-
|
|
4
|
+
WHAT — When the repo has no GitHub PR template, structure the pull-request body using the default in references/pr-body-default.md. Pair with output-handshake and github-cli-workflow. Does not open the PR; HOW stays in the forge skill.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# PR body — default when no repo template (WHAT)
|
|
8
|
+
|
|
9
|
+
## When to use
|
|
10
|
+
|
|
11
|
+
- Remote is **GitHub** and **`assistant`** (or a file search) shows **no** `PULL_REQUEST_TEMPLATE` / `pull_request_template` under `.github/`.
|
|
12
|
+
- You need a **reasonable default** for `gh pr create --body-file` until the repo adds its own template.
|
|
13
|
+
|
|
14
|
+
## Instructions
|
|
15
|
+
|
|
16
|
+
1. Run **`output-handshake`**: user confirms where the final description will live (e.g. `body.md` for `gh`, paste-only) and that a **human** will review.
|
|
17
|
+
2. If the repository adds a template later, **prefer the repo** over this file.
|
|
18
|
+
3. Copy sections from **`references/pr-body-default.md`**, fill placeholders (issue id, test notes), and pass the path to **`github-cli-workflow`**.
|
|
19
|
+
|
|
20
|
+
## GitLab
|
|
21
|
+
|
|
22
|
+
If there is no `.gitlab/merge_request_templates/`, you may use the same Markdown structure in the **merge request description** for consistency, subject to the user’s **destination** choice (MR description field, file, etc.) and **`output-handshake`**.
|
|
23
|
+
|
|
24
|
+
## What not to do
|
|
25
|
+
|
|
26
|
+
- Do not **assume** a PR is always in a specific ticket system; the **file** the user points to is wherever they said in the handshake.
|
|
27
|
+
|
|
28
|
+
## References
|
|
29
|
+
|
|
30
|
+
- `references/pr-body-default.md` — local copy of the default body
|
|
31
|
+
- `development-workflow` — default PR validation and DoD expectations
|
|
32
|
+
- `github-cli-workflow` — draft PR creation
|
|
33
|
+
- `gitlab-cli-workflow` — GitLab MRs
|
|
File without changes
|
agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/core/workspace-knowledge-sync/SKILL.md
ADDED
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: workspace-knowledge-sync
|
|
3
|
+
description: >-
|
|
4
|
+
Syncs knowledge to the ai-workspace knowledge base. Use when the assistant
|
|
5
|
+
discovers new patterns, learns user preferences, or identifies information worth
|
|
6
|
+
preserving for future sessions. Integrates with tech-assistant for automatic
|
|
7
|
+
trigger points.
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Workspace Knowledge Sync
|
|
11
|
+
|
|
12
|
+
Automatically syncs valuable discoveries, patterns, and decisions to the ai-workspace knowledge base.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## Purpose
|
|
17
|
+
|
|
18
|
+
The orchestrator session accumulates knowledge through work. This skill ensures that valuable discoveries don't get lost and are available for future sessions.
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Trigger Points (Automatic)
|
|
23
|
+
|
|
24
|
+
The tech-assistant will invoke this skill automatically when:
|
|
25
|
+
|
|
26
|
+
| Situation | What to Sync | Target File |
|
|
27
|
+
|-----------|--------------|-------------|
|
|
28
|
+
| Discovery of new skill/tool | Skill name, purpose, usage pattern | `knowledge/skills/discovered.md` |
|
|
29
|
+
| New process pattern | Process steps, roles, tools | `knowledge/processes/general.md` |
|
|
30
|
+
| Key decision made | Decision, rationale, outcome | `knowledge/learnings/general.md` |
|
|
31
|
+
| Pending follow-up | Task description, context | `knowledge/todos/pending.md` |
|
|
32
|
+
| User teaches something | Information, preference | Relevant knowledge file |
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## How It Works
|
|
37
|
+
|
|
38
|
+
The skill uses the stable `assistant-memory` API with `--from-skill` for origin tracking:
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
# Search before adding
|
|
42
|
+
assistant-memory search "<query>"
|
|
43
|
+
|
|
44
|
+
# Add a learning (with origin tracking)
|
|
45
|
+
assistant-memory add --type learning --from-skill knowledge-sync "Pattern: <description>"
|
|
46
|
+
|
|
47
|
+
# Add a skill (with tags)
|
|
48
|
+
assistant-memory add --type skill --from-skill knowledge-sync --tags jira,workflow "New skill: <name>"
|
|
49
|
+
|
|
50
|
+
# Add a pending todo
|
|
51
|
+
assistant-memory add --type todo --from-skill knowledge-sync "<description>"
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## Knowledge Structure
|
|
57
|
+
|
|
58
|
+
```
|
|
59
|
+
knowledge/
|
|
60
|
+
├── skills/
|
|
61
|
+
│ └── discovered.md # New skills found during work
|
|
62
|
+
├── processes/
|
|
63
|
+
│ ├── jira.md
|
|
64
|
+
│ ├── confluence.md
|
|
65
|
+
│ └── general.md # Generic process patterns
|
|
66
|
+
├── learnings/
|
|
67
|
+
│ └── general.md # Key decisions and insights
|
|
68
|
+
└── todos/
|
|
69
|
+
└── pending.md # Follow-up items
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## Manual Usage
|
|
75
|
+
|
|
76
|
+
You can also trigger this skill manually:
|
|
77
|
+
|
|
78
|
+
```
|
|
79
|
+
User: "Save that pattern for later"
|
|
80
|
+
|
|
81
|
+
Assistant: → Use knowledge-sync to preserve the pattern
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## Integration with tech-assistant
|
|
87
|
+
|
|
88
|
+
The tech-assistant skill checks for these automatic sync opportunities:
|
|
89
|
+
|
|
90
|
+
1. **After task creation/update** → Sync initiative info
|
|
91
|
+
2. **After discovering space/list IDs** → Sync to knowledge base (per `knowledge-sync`).
|
|
92
|
+
3. **After learning user preferences** → Sync to learnings
|
|
93
|
+
4. **When user mentions follow-up** → Add to pending
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## Best Practices
|
|
98
|
+
|
|
99
|
+
1. **Be selective** - Only sync valuable, reusable information
|
|
100
|
+
2. **Be specific** - Include context and usage examples
|
|
101
|
+
3. **Be concise** - One idea per entry, link to details
|
|
102
|
+
4. **Be current** - Update outdated information when found
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## Examples
|
|
107
|
+
|
|
108
|
+
### Auto-sync discovery
|
|
109
|
+
|
|
110
|
+
```
|
|
111
|
+
Assistant discovers Initiative list IDs for all Technology spaces
|
|
112
|
+
→ Syncs to knowledge/processes/clickup/spaces/
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
### Auto-sync key decision
|
|
116
|
+
|
|
117
|
+
```
|
|
118
|
+
Assistant and user decide on naming convention
|
|
119
|
+
→ Syncs to knowledge/learnings/general.md
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
### Manual sync request
|
|
123
|
+
|
|
124
|
+
```
|
|
125
|
+
User: "Remember that we always use feature branches"
|
|
126
|
+
→ Assistant syncs to knowledge/processes/general.md
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
---
|
|
130
|
+
|
|
131
|
+
## Configuration
|
|
132
|
+
|
|
133
|
+
The skill uses these environment variables:
|
|
134
|
+
|
|
135
|
+
| Variable | Default | Purpose |
|
|
136
|
+
|----------|---------|---------|
|
|
137
|
+
| `KNOWLEDGE_BASE_PATH` | `~/ai-workspace/knowledge` | Knowledge base root |
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
Base directory: `~/.local/share//skills/knowledge-sync`
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: dbt-validation
|
|
3
|
+
description: >-
|
|
4
|
+
HOW — Run dbt checks as documented in the target repo (parse, compile, test, selective run).
|
|
5
|
+
Does not configure Snowflake accounts or change cloud security.
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# dbt validation (HOW)
|
|
9
|
+
|
|
10
|
+
Use when the repository is a **dbt** project or the task requires **dbt** verification. Client workflows may delegate here.
|
|
11
|
+
|
|
12
|
+
## Boundaries
|
|
13
|
+
|
|
14
|
+
- Follow **repo** `AGENTS.md`, `Makefile`, `README`, and CI—not generic guesses.
|
|
15
|
+
- **Do not** change Snowflake security settings, network rules, or warehouse admin from this skill.
|
|
16
|
+
- If `dbt` or credentials are missing, **say so** and do not claim validation passed.
|
|
17
|
+
|
|
18
|
+
## Discovery
|
|
19
|
+
|
|
20
|
+
Look for `dbt_project.yml`, `packages.yml`, `models/`, `Makefile`, `pyproject.toml`, or CI jobs that invoke dbt.
|
|
21
|
+
|
|
22
|
+
## Typical commands (examples only—prefer repo docs)
|
|
23
|
+
|
|
24
|
+
| Intent | Often used (verify in repo) |
|
|
25
|
+
| --- | --- |
|
|
26
|
+
| Syntax / graph | `dbt parse`, `dbt compile` |
|
|
27
|
+
| Dependencies | `dbt deps` when packages change |
|
|
28
|
+
| Tests | `dbt test` or subset flags the repo documents |
|
|
29
|
+
| Build | `dbt run` / `dbt build` when the user approves mutating runs |
|
|
30
|
+
|
|
31
|
+
**Makefile** wrappers (e.g. `make parse`) take precedence when documented.
|
|
32
|
+
|
|
33
|
+
## Evidence
|
|
34
|
+
|
|
35
|
+
- Summarize **which** commands ran and **high-level** outcome (pass/fail/skipped) for tickets and PRs.
|
|
36
|
+
- On failure, capture **actionable** error lines; do not dump full logs unless the user asks.
|
|
37
|
+
|
|
38
|
+
## Safety
|
|
39
|
+
|
|
40
|
+
- Prefer **read-only** checks (`parse`, `compile`, `test`) when the task is review-only.
|
|
41
|
+
- Production runs require explicit user approval per repo policy.
|
agent_toolkit_cli-1.0.3.data/data/agent_toolkit/data/skills/data/snowflake-validation/SKILL.md
ADDED
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: snowflake-validation
|
|
3
|
+
description: >-
|
|
4
|
+
HOW — Read-only Snowflake validation patterns: use repo-documented CLI (snowflake/sql) or SQL checks.
|
|
5
|
+
Never claim success without working credentials and evidence.
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Snowflake validation (HOW)
|
|
9
|
+
|
|
10
|
+
Use when the task or repo requires **Snowflake** verification. Client workflows may delegate here alongside **dbt-validation**.
|
|
11
|
+
|
|
12
|
+
## Boundaries
|
|
13
|
+
|
|
14
|
+
- **Read-only** validation unless the user and repo explicitly authorize DDL/DML.
|
|
15
|
+
- **Never** claim “Snowflake validation passed” or “query succeeded” without **credentials** and **observed outputs** (or explicit statement that checks were skipped).
|
|
16
|
+
- **Do not** rotate keys, change roles, or alter security objects from this skill unless the repo’s `AGENTS.md` clearly authorizes it and the user approves.
|
|
17
|
+
|
|
18
|
+
## Discovery
|
|
19
|
+
|
|
20
|
+
Read repo docs for: connection method (env vars, `profiles.yml`, SSO), Snowflake **SQL** or **Snowflake CLI** (`snow`) usage, and warehouse/database/schema defaults.
|
|
21
|
+
|
|
22
|
+
## Patterns
|
|
23
|
+
|
|
24
|
+
| Situation | Action |
|
|
25
|
+
| --- | --- |
|
|
26
|
+
| Credentials available | Run minimal **SELECT** statements or documented smoke queries; record that they were executed |
|
|
27
|
+
| Snowflake CLI documented | Use repo’s exact commands; check `snow --help` for current subcommands |
|
|
28
|
+
| No credentials | State **skipped** in Jira/PR; list what would be validated when access exists |
|
|
29
|
+
| dbt + Snowflake | Coordinate with **dbt-validation**; Snowflake may be exercised indirectly via dbt |
|
|
30
|
+
|
|
31
|
+
## Evidence
|
|
32
|
+
|
|
33
|
+
- For each run: **what** ran (object or test name), **environment** (non-secret), **result** (row count, success/failure).
|
|
34
|
+
- Redact account identifiers if the user requests privacy in chat.
|
|
35
|
+
|
|
36
|
+
## Safety
|
|
37
|
+
|
|
38
|
+
- No secrets in tickets, PRs, or command lines in logs pasted to chat—use env vars and documented patterns only.
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: adr
|
|
3
|
+
description: >-
|
|
4
|
+
WHAT — Create and maintain Architecture Decision Records (ADRs) per the process. Covers when to write an ADR, required sections, review, and linking to epics/PRs. English for cross-team artifacts unless the user asks otherwise.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# ADR — Architecture Decisions (WHAT)
|
|
8
|
+
|
|
9
|
+
**Template:** `references/default-template.md` — local reference for ADR structure and workflow.
|
|
10
|
+
|
|
11
|
+
## Default guardrails (before any final content)
|
|
12
|
+
|
|
13
|
+
1. Apply **`output-handshake`**: confirm **where** the final ADR will be recorded and that a **human** will review.
|
|
14
|
+
2. Then follow the steps below.
|
|
15
|
+
|
|
16
|
+
## When to use
|
|
17
|
+
|
|
18
|
+
Use **`decision-log`** for lightweight product/project/operational decisions and **`agreement`** for explicit commitments or terms among parties. Use this ADR skill only for durable architecture or technical decisions.
|
|
19
|
+
|
|
20
|
+
- A change has **long-term** architectural, security, data-model, or cost impact.
|
|
21
|
+
- You need **options with pros/cons** and a **record** for future readers (and for supersession later).
|
|
22
|
+
- The project needs decisions linked to PRDs, TRDs, tasks, PRs, diagrams, or other supporting artifacts.
|
|
23
|
+
|
|
24
|
+
## Instructions
|
|
25
|
+
|
|
26
|
+
1. **Confirm the decision qualifies** (new service, tech selection, schema change, deployment change, etc.) per the "When to Create an ADR" criteria.
|
|
27
|
+
2. **Draft** using the six-part structure: Title & status, Context, Options, Decision, Consequences, References (link **PRD/TRD**, tasks, PRs, diagrams as applicable).
|
|
28
|
+
3. **Review** with the tech lead / peers as in the workflow; keep ADRs **short and actionable** (clarity over completeness).
|
|
29
|
+
4. **Link** the ADR to the relevant **epic or story** and to **PRs** in the forge (use **`github-cli-workflow` / `gitlab-cli-workflow`** for PR text when applicable).
|
|
30
|
+
5. If an ADR is **superseded**, **preserve history**: update status and point to the replacement document.
|
|
31
|
+
|
|
32
|
+
## What not to do
|
|
33
|
+
|
|
34
|
+
- Do not use an ADR for one-line fixes with no long-term effect (use a normal task or PR description).
|
|
35
|
+
- Do not paste the full org policy into this skill; keep a single **canonical** copy in the wiki.
|
|
36
|
+
|
|
37
|
+
## References
|
|
38
|
+
|
|
39
|
+
- `output-handshake` — destination and review
|
|
40
|
+
- `references/default-template.md` — ADR structure and workflow
|
|
41
|
+
- `references/example-001-graphql-adoption.md` — example ADR for a GraphQL migration decision
|
|
42
|
+
- `trd` — where technical design references decisions
|
|
43
|
+
- `decision-log` — lightweight decisions
|
|
44
|
+
- `agreement` — explicit commitments or terms
|
|
45
|
+
- `workflow-generic-project` — traceability and plan approval
|
|
46
|
+
- `clickup-cli`, `jira-*` — ticket and comment operations (per engagement)
|
|
File without changes
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# ADR-001: Adopt GraphQL for the Product API
|
|
2
|
+
|
|
3
|
+
**Status:** Accepted
|
|
4
|
+
|
|
5
|
+
## Context
|
|
6
|
+
|
|
7
|
+
The current REST API has accumulated significant complexity as the product domain grew. Multiple frontend clients (web, mobile) are experiencing over-fetching, under-fetching, and fragile coupling to backend structure. The team spends significant time on API versioning and backward compatibility work.
|
|
8
|
+
|
|
9
|
+
Key constraints:
|
|
10
|
+
- Existing REST endpoints cannot be deprecated immediately
|
|
11
|
+
- Mobile team needs faster iteration cycles
|
|
12
|
+
- Analytics requirements demand a more expressive data querying interface
|
|
13
|
+
|
|
14
|
+
## Options Considered
|
|
15
|
+
|
|
16
|
+
### Option A: GraphQL Federation
|
|
17
|
+
**Pros:**
|
|
18
|
+
- Single coherent graph for all clients
|
|
19
|
+
- Type safety and auto-generated docs
|
|
20
|
+
- Separate subgraph ownership reduces coupling
|
|
21
|
+
|
|
22
|
+
**Cons:**
|
|
23
|
+
- Higher initial infrastructure complexity
|
|
24
|
+
- Requires Apollo Federation or equivalent gateway
|
|
25
|
+
- Caching strategies differ from REST patterns
|
|
26
|
+
|
|
27
|
+
### Option B: REST with JSON:API
|
|
28
|
+
**Pros:**
|
|
29
|
+
- Team familiarity with REST patterns
|
|
30
|
+
- Simpler infrastructure (no gateway needed)
|
|
31
|
+
- Easier to cache at CDN level
|
|
32
|
+
|
|
33
|
+
**Cons:**
|
|
34
|
+
- Still requires versioning as domain grows
|
|
35
|
+
- Multiple endpoints needed for complex queries
|
|
36
|
+
- No built-in type safety or schema
|
|
37
|
+
|
|
38
|
+
### Option C:渐进式迁移 — Evolve REST to GraphQL incrementally
|
|
39
|
+
**Pros:**
|
|
40
|
+
- Low risk approach
|
|
41
|
+
- Existing clients unaffected during transition
|
|
42
|
+
- Can validate GraphQL value before full commitment
|
|
43
|
+
|
|
44
|
+
**Cons:**
|
|
45
|
+
- Longer timeline to realize benefits
|
|
46
|
+
- Requires maintaining both API styles temporarily
|
|
47
|
+
- Higher total implementation effort
|
|
48
|
+
|
|
49
|
+
## Decision
|
|
50
|
+
|
|
51
|
+
Adopt GraphQL with a phased approach: establish a new `/graphql` endpoint alongside existing REST, migrate the product domain first, then expand to other domains as teams gain familiarity.
|
|
52
|
+
|
|
53
|
+
Rationale: Provides immediate relief for frontend teams while preserving existing investments. The federation model future-proofs architecture for microservices decomposition.
|
|
54
|
+
|
|
55
|
+
## Consequences
|
|
56
|
+
|
|
57
|
+
- New `api-gateway` service will be introduced in Q3
|
|
58
|
+
- Mobile team leads the product domain migration (most urgent need)
|
|
59
|
+
- REST API maintained for backward compatibility until deprecation notice (6-month notice period)
|
|
60
|
+
- Existing client SDKs updated to support both endpoints during transition
|
|
61
|
+
|
|
62
|
+
## References
|
|
63
|
+
|
|
64
|
+
- [PRD-042: Unified API Strategy](./prd-042-unified-api-strategy.md)
|
|
65
|
+
- [Spike-012: GraphQL vs REST evaluation](./spike-012-graphql-evaluation.md)
|
|
66
|
+
- Engineering sync 2024-11-15
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: agreement
|
|
3
|
+
description: >-
|
|
4
|
+
WHAT - Capture explicit agreements, terms, parties involved, dates, validity, and linked work items using the Agreement Document structure.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Agreement Document (WHAT)
|
|
8
|
+
|
|
9
|
+
Use for formal agreements or commitments made during meetings or project discussions.
|
|
10
|
+
|
|
11
|
+
## Default guardrails
|
|
12
|
+
|
|
13
|
+
1. Apply **`output-handshake`** before final output.
|
|
14
|
+
2. Identify parties involved and affected.
|
|
15
|
+
3. Include validity/review dates when the agreement has a time boundary.
|
|
16
|
+
4. Link related work items and meeting minutes where possible.
|
|
17
|
+
|
|
18
|
+
## References
|
|
19
|
+
|
|
20
|
+
- `references/default-template.md`
|
|
21
|
+
- `references/example-api-versioning.md` — example agreement covering semantic versioning and deprecation policy
|
|
22
|
+
- `meeting-minutes`
|
|
23
|
+
- `decision-log`
|
|
File without changes
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Agreement: API Versioning Policy
|
|
2
|
+
|
|
3
|
+
## Agreement Summary
|
|
4
|
+
|
|
5
|
+
All public APIs will follow semantic versioning with a minimum 6-month deprecation notice before breaking changes. Version support windows are tied to major versions.
|
|
6
|
+
|
|
7
|
+
## Parties Involved
|
|
8
|
+
|
|
9
|
+
- Platform Team (API owners)
|
|
10
|
+
- All consuming service teams
|
|
11
|
+
- Product Management (for public API consumers)
|
|
12
|
+
|
|
13
|
+
## Terms and Conditions
|
|
14
|
+
|
|
15
|
+
1. **Version numbering:** Follows `MAJOR.MINOR.PATCH` semantic versioning
|
|
16
|
+
2. **Breaking changes:** Require a new major version with 6-month overlap period
|
|
17
|
+
3. **Deprecation notice:** Written notice in API response headers and changelog minimum 6 months before EOL
|
|
18
|
+
4. **Sunset timeline:** Major versions receive security patches for 18 months from release, then EOL
|
|
19
|
+
5. **Version discovery:** `/versions` endpoint lists supported versions with EOL dates
|
|
20
|
+
|
|
21
|
+
## Date and Validity
|
|
22
|
+
|
|
23
|
+
- Start Date: 2024-01-01
|
|
24
|
+
- Review / Due Date: 2025-07-01 (first review)
|
|
25
|
+
|
|
26
|
+
## References / Linked Work Items
|
|
27
|
+
|
|
28
|
+
- [ADR-003: API Versioning Standard](./adr-003-api-versioning.md)
|
|
29
|
+
- [TRD-007: Platform API Migration](./trd-007-platform-api-migration.md)
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: bug
|
|
3
|
+
description: >-
|
|
4
|
+
WHAT - Draft and review bugs using the Bug Template; classifies whether an issue should be escalated to incident based on production/user impact.
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Bug (WHAT)
|
|
8
|
+
|
|
9
|
+
Use for defects that can be handled through the normal development workflow.
|
|
10
|
+
|
|
11
|
+
## Bug vs incident rule
|
|
12
|
+
|
|
13
|
+
Route to **`incident`** instead if the problem impacts production or live users now, degrades service, blocks critical business operations, creates client-reported urgency, or needs immediate response outside planning cycles.
|
|
14
|
+
|
|
15
|
+
## Default guardrails
|
|
16
|
+
|
|
17
|
+
1. Apply **`output-handshake`** before final output.
|
|
18
|
+
2. Capture reproduction steps and environment details.
|
|
19
|
+
3. Use **`clickup-cli`** for ClickUp writes only after approval.
|
|
20
|
+
|
|
21
|
+
## References
|
|
22
|
+
|
|
23
|
+
- `references/default-template.md` — bug template
|
|
24
|
+
- `references/example-search-filter-bug.md` — example bug with environment details, diagnostics, and severity assessment
|
|
25
|
+
- `incident` — when to escalate to incident
|
|
File without changes
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# BUG-042: Search results not displaying after deployment
|
|
2
|
+
|
|
3
|
+
## Steps to Reproduce
|
|
4
|
+
|
|
5
|
+
1. Navigate to `/products` with query parameter `?category=electronics&sort=price_asc`
|
|
6
|
+
2. Click on the "Filter" button to open the filter panel
|
|
7
|
+
3. Select "Screen Size: 40-50 inch" and click Apply
|
|
8
|
+
4. Observe the results area
|
|
9
|
+
|
|
10
|
+
## Expected Result
|
|
11
|
+
|
|
12
|
+
Product grid updates to show only electronics with screen sizes between 40 and 50 inches, sorted by price ascending. Total count shows "47 products found".
|
|
13
|
+
|
|
14
|
+
## Actual Result
|
|
15
|
+
|
|
16
|
+
Results area shows a spinner indefinitely. Network tab shows 200 response but no DOM updates. After 30 seconds the spinner is replaced with an empty state: "No products match your filters."
|
|
17
|
+
|
|
18
|
+
## Environment Details
|
|
19
|
+
|
|
20
|
+
| Field | Value |
|
|
21
|
+
| --- | --- |
|
|
22
|
+
| Environment | Production |
|
|
23
|
+
| Browser | Chrome 120.0.6099.130 |
|
|
24
|
+
| Device / OS | macOS 14.2 (M2 Pro) |
|
|
25
|
+
| App Version | 2.14.1 |
|
|
26
|
+
| User Role | Authenticated consumer |
|
|
27
|
+
| Network Conditions | WiFi, 50 Mbps down |
|
|
28
|
+
|
|
29
|
+
## Diagnostics and Observations
|
|
30
|
+
|
|
31
|
+
- Screenshots, videos, or logs: [Recording attached to ticket]
|
|
32
|
+
- Console errors or stack traces: `TypeError: Cannot read properties of undefined (reading 'length')` at `FilterPanel.jsx:142`
|
|
33
|
+
- External system behavior: Analytics events fire successfully — the failure is in frontend rendering only
|
|
34
|
+
- Previous working version: 2.13.4 (verified via rollback test)
|
|
35
|
+
|
|
36
|
+
## Acceptance Criteria
|
|
37
|
+
|
|
38
|
+
- [ ] Expected behavior is working and manually verified in Production.
|
|
39
|
+
- [ ] Original reproduction steps no longer reproduce the bug.
|
|
40
|
+
- [ ] Fix was tested in the relevant environment (Production-like staging).
|
|
41
|
+
- [ ] Resolution evidence was added (recording, logs confirming the TypeError is gone).
|
|
42
|
+
- [ ] Documentation or user guidance was updated if needed (release notes mention the fix).
|
|
43
|
+
|
|
44
|
+
## Severity and Priority
|
|
45
|
+
|
|
46
|
+
- Severity: High
|
|
47
|
+
- Priority: P1
|
|
48
|
+
|
|
49
|
+
## Additional Information
|
|
50
|
+
|
|
51
|
+
- Estimated Effort: 2 days
|
|
52
|
+
- Assigned To: Sarah Chen
|
|
53
|
+
- Due Date: 2024-01-20
|
|
54
|
+
|
|
55
|
+
## Review
|
|
56
|
+
|
|
57
|
+
- [ ] Destination confirmed.
|
|
58
|
+
- [ ] Human review required.
|