@opengsd/gsd-core 1.2.0 → 1.3.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/README.ja-JP.md +46 -791
- package/README.ko-KR.md +44 -780
- package/README.md +42 -218
- package/README.pt-BR.md +47 -414
- package/README.zh-CN.md +46 -763
- package/agents/gsd-ai-researcher.md +2 -2
- package/agents/gsd-debug-session-manager.md +1 -1
- package/agents/gsd-debugger.md +8 -8
- package/agents/gsd-doc-writer.md +7 -6
- package/agents/gsd-domain-researcher.md +15 -2
- package/agents/gsd-eval-auditor.md +1 -1
- package/agents/gsd-eval-planner.md +2 -2
- package/agents/gsd-executor.md +21 -8
- package/agents/gsd-framework-selector.md +1 -1
- package/agents/gsd-intel-updater.md +4 -4
- package/agents/gsd-phase-researcher.md +19 -6
- package/agents/gsd-plan-checker.md +3 -3
- package/agents/gsd-planner.md +36 -23
- package/agents/gsd-project-researcher.md +13 -0
- package/agents/gsd-research-synthesizer.md +6 -2
- package/agents/gsd-roadmapper.md +6 -6
- package/agents/gsd-ui-researcher.md +16 -3
- package/agents/gsd-user-profiler.md +2 -2
- package/agents/gsd-verifier.md +8 -8
- package/assets/gsd-logo-2000-transparent.png +0 -0
- package/assets/gsd-logo-2000-transparent.svg +17 -0
- package/assets/gsd-logo-2000.png +0 -0
- package/assets/gsd-logo-2000.svg +21 -0
- package/assets/terminal.svg +68 -0
- package/bin/install.js +255 -103
- package/commands/gsd/add-tests.md +1 -1
- package/commands/gsd/ai-integration-phase.md +3 -3
- package/commands/gsd/audit-fix.md +1 -1
- package/commands/gsd/audit-milestone.md +1 -1
- package/commands/gsd/audit-uat.md +1 -1
- package/commands/gsd/autonomous.md +2 -2
- package/commands/gsd/capture.md +6 -6
- package/commands/gsd/cleanup.md +1 -1
- package/commands/gsd/code-review.md +1 -1
- package/commands/gsd/complete-milestone.md +2 -2
- package/commands/gsd/config.md +3 -3
- package/commands/gsd/debug.md +1 -1
- package/commands/gsd/discuss-phase.md +5 -4
- package/commands/gsd/docs-update.md +1 -1
- package/commands/gsd/eval-review.md +2 -2
- package/commands/gsd/execute-phase.md +2 -2
- package/commands/gsd/explore.md +1 -1
- package/commands/gsd/extract-learnings.md +2 -2
- package/commands/gsd/fast.md +1 -1
- package/commands/gsd/forensics.md +1 -1
- package/commands/gsd/graphify.md +9 -9
- package/commands/gsd/health.md +1 -1
- package/commands/gsd/help.md +2 -2
- package/commands/gsd/import.md +5 -5
- package/commands/gsd/inbox.md +1 -1
- package/commands/gsd/ingest-docs.md +4 -4
- package/commands/gsd/manager.md +3 -3
- package/commands/gsd/map-codebase.md +1 -1
- package/commands/gsd/milestone-summary.md +1 -1
- package/commands/gsd/mvp-phase.md +4 -4
- package/commands/gsd/new-milestone.md +5 -5
- package/commands/gsd/new-project.md +5 -5
- package/commands/gsd/pause-work.md +2 -2
- package/commands/gsd/phase.md +4 -4
- package/commands/gsd/plan-phase.md +2 -2
- package/commands/gsd/plan-review-convergence.md +4 -4
- package/commands/gsd/pr-branch.md +1 -1
- package/commands/gsd/profile-user.md +2 -2
- package/commands/gsd/progress.md +4 -4
- package/commands/gsd/quick.md +1 -1
- package/commands/gsd/resume-work.md +1 -1
- package/commands/gsd/review.md +3 -2
- package/commands/gsd/secure-phase.md +1 -1
- package/commands/gsd/settings.md +1 -1
- package/commands/gsd/ship.md +2 -2
- package/commands/gsd/sketch.md +7 -7
- package/commands/gsd/spec-phase.md +2 -2
- package/commands/gsd/spike.md +3 -3
- package/commands/gsd/stats.md +1 -1
- package/commands/gsd/surface.md +4 -4
- package/commands/gsd/thread.md +1 -1
- package/commands/gsd/ui-phase.md +2 -2
- package/commands/gsd/ui-review.md +2 -2
- package/commands/gsd/ultraplan-phase.md +2 -2
- package/commands/gsd/undo.md +3 -3
- package/commands/gsd/update.md +3 -3
- package/commands/gsd/validate-phase.md +1 -1
- package/commands/gsd/verify-work.md +2 -2
- package/commands/gsd/workspace.md +4 -4
- package/{get-shit-done → gsd-core}/bin/check-latest-version.cjs +1 -1
- package/{get-shit-done → gsd-core}/bin/gsd-tools.cjs +50 -4
- package/gsd-core/bin/lib/active-workstream-store.cjs +291 -0
- package/gsd-core/bin/lib/adr-parser.cjs +399 -0
- package/gsd-core/bin/lib/agent-command-router.cjs +68 -0
- package/gsd-core/bin/lib/artifacts.cjs +51 -0
- package/gsd-core/bin/lib/audit.cjs +743 -0
- package/gsd-core/bin/lib/check-command-router.cjs +342 -0
- package/gsd-core/bin/lib/cjs-command-router-adapter.cjs +81 -0
- package/gsd-core/bin/lib/clock.cjs +95 -0
- package/gsd-core/bin/lib/clusters.cjs +128 -0
- package/gsd-core/bin/lib/code-review-flags.cjs +59 -0
- package/gsd-core/bin/lib/command-aliases.cjs +809 -0
- package/gsd-core/bin/lib/command-arg-projection.cjs +55 -0
- package/gsd-core/bin/lib/command-routing-hub.cjs +300 -0
- package/gsd-core/bin/lib/commands.cjs +1202 -0
- package/gsd-core/bin/lib/config-schema.cjs +29 -0
- package/gsd-core/bin/lib/config-types.cjs +19 -0
- package/gsd-core/bin/lib/config.cjs +714 -0
- package/{get-shit-done → gsd-core}/bin/lib/configuration.cjs +76 -85
- package/gsd-core/bin/lib/context-utilization.cjs +48 -0
- package/gsd-core/bin/lib/core.cjs +2007 -0
- package/{get-shit-done → gsd-core}/bin/lib/decisions.cjs +9 -7
- package/gsd-core/bin/lib/docs.cjs +252 -0
- package/gsd-core/bin/lib/drift.cjs +364 -0
- package/gsd-core/bin/lib/fallow-runner.cjs +115 -0
- package/gsd-core/bin/lib/frontmatter.cjs +442 -0
- package/gsd-core/bin/lib/gap-checker.cjs +257 -0
- package/gsd-core/bin/lib/graphify.cjs +496 -0
- package/gsd-core/bin/lib/gsd2-import.cjs +456 -0
- package/gsd-core/bin/lib/init-command-router.cjs +62 -0
- package/gsd-core/bin/lib/init.cjs +1799 -0
- package/gsd-core/bin/lib/install-profiles.cjs +526 -0
- package/gsd-core/bin/lib/installer-migration-authoring.cjs +122 -0
- package/gsd-core/bin/lib/installer-migration-report.cjs +347 -0
- package/gsd-core/bin/lib/installer-migrations/000-first-time-baseline.cjs +218 -0
- package/gsd-core/bin/lib/installer-migrations/001-legacy-orphan-files.cjs +48 -0
- package/gsd-core/bin/lib/installer-migrations/002-codex-legacy-hooks-json.cjs +94 -0
- package/gsd-core/bin/lib/installer-migrations/003-rename-get-shit-done-to-gsd-core.cjs +108 -0
- package/gsd-core/bin/lib/installer-migrations.cjs +784 -0
- package/gsd-core/bin/lib/intel.cjs +607 -0
- package/gsd-core/bin/lib/learnings.cjs +270 -0
- package/gsd-core/bin/lib/legacy-cleanup.cjs +253 -0
- package/gsd-core/bin/lib/milestone.cjs +373 -0
- package/gsd-core/bin/lib/model-catalog.cjs +154 -0
- package/gsd-core/bin/lib/model-profiles.cjs +24 -0
- package/gsd-core/bin/lib/observability/event.cjs +51 -0
- package/gsd-core/bin/lib/observability/logger.cjs +146 -0
- package/{get-shit-done → gsd-core}/bin/lib/observability/redaction.cjs +19 -21
- package/{get-shit-done → gsd-core}/bin/lib/package-identity.cjs +5 -1
- package/gsd-core/bin/lib/phase-command-router.cjs +189 -0
- package/gsd-core/bin/lib/phase-lifecycle.cjs +74 -0
- package/gsd-core/bin/lib/phase.cjs +1307 -0
- package/gsd-core/bin/lib/phases-command-router.cjs +43 -0
- package/{get-shit-done → gsd-core}/bin/lib/plan-scan.cjs +18 -24
- package/gsd-core/bin/lib/planning-workspace.cjs +245 -0
- package/gsd-core/bin/lib/profile-output.cjs +1120 -0
- package/gsd-core/bin/lib/profile-pipeline.cjs +517 -0
- package/gsd-core/bin/lib/project-root.cjs +119 -0
- package/gsd-core/bin/lib/prompt-budget.cjs +305 -0
- package/gsd-core/bin/lib/review-reviewer-selection.cjs +121 -0
- package/gsd-core/bin/lib/roadmap-command-router.cjs +166 -0
- package/gsd-core/bin/lib/roadmap-upgrade.cjs +491 -0
- package/gsd-core/bin/lib/roadmap.cjs +600 -0
- package/gsd-core/bin/lib/runtime-artifact-layout.cjs +254 -0
- package/gsd-core/bin/lib/runtime-homes.cjs +169 -0
- package/gsd-core/bin/lib/runtime-name-policy.cjs +96 -0
- package/gsd-core/bin/lib/runtime-slash.cjs +119 -0
- package/{get-shit-done → gsd-core}/bin/lib/schema-detect.cjs +20 -26
- package/gsd-core/bin/lib/secrets.cjs +34 -0
- package/gsd-core/bin/lib/security.cjs +407 -0
- package/gsd-core/bin/lib/semver-compare.cjs +42 -0
- package/gsd-core/bin/lib/shell-command-projection.cjs +524 -0
- package/gsd-core/bin/lib/state-command-router.cjs +160 -0
- package/{get-shit-done → gsd-core}/bin/lib/state-document.cjs +78 -82
- package/gsd-core/bin/lib/state.cjs +2010 -0
- package/gsd-core/bin/lib/surface.cjs +406 -0
- package/gsd-core/bin/lib/task-command-router.cjs +85 -0
- package/gsd-core/bin/lib/template.cjs +237 -0
- package/gsd-core/bin/lib/uat.cjs +297 -0
- package/gsd-core/bin/lib/ui-safety-gate.cjs +98 -0
- package/gsd-core/bin/lib/update-context.cjs +218 -0
- package/gsd-core/bin/lib/validate-command-router.cjs +91 -0
- package/gsd-core/bin/lib/validate.cjs +112 -0
- package/gsd-core/bin/lib/verify-command-router.cjs +44 -0
- package/gsd-core/bin/lib/verify.cjs +1451 -0
- package/{get-shit-done → gsd-core}/bin/lib/workstream-inventory-builder.cjs +19 -12
- package/gsd-core/bin/lib/workstream-inventory.cjs +147 -0
- package/{get-shit-done → gsd-core}/bin/lib/workstream-name-policy.cjs +28 -31
- package/gsd-core/bin/lib/workstream.cjs +380 -0
- package/gsd-core/bin/lib/worktree-safety.cjs +912 -0
- package/{get-shit-done → gsd-core}/bin/shared/config-defaults.manifest.json +1 -0
- package/{get-shit-done → gsd-core}/bin/shared/config-schema.manifest.json +17 -1
- package/{get-shit-done → gsd-core}/bin/shared/model-catalog.json +27 -0
- package/{get-shit-done → gsd-core}/references/artifact-types.md +1 -1
- package/{get-shit-done → gsd-core}/references/checkpoints.md +1 -1
- package/{get-shit-done → gsd-core}/references/few-shot-examples/plan-checker.md +2 -2
- package/{get-shit-done → gsd-core}/references/few-shot-examples/verifier.md +12 -12
- package/{get-shit-done → gsd-core}/references/model-profile-resolution.md +1 -1
- package/{get-shit-done → gsd-core}/references/mvp-concepts.md +1 -1
- package/{get-shit-done → gsd-core}/references/planner-graphify-auto-update.md +2 -2
- package/{get-shit-done → gsd-core}/references/planner-human-verify-mode.md +1 -1
- package/{get-shit-done → gsd-core}/references/planner-mvp-mode.md +1 -1
- package/{get-shit-done → gsd-core}/references/ui-brand.md +4 -2
- package/{get-shit-done → gsd-core}/references/verification-patterns.md +1 -1
- package/gsd-core/references/worktree-branch-check.md +38 -0
- package/{get-shit-done → gsd-core}/references/worktree-path-safety.md +4 -26
- package/{get-shit-done → gsd-core}/templates/README.md +2 -2
- package/{get-shit-done → gsd-core}/templates/codebase/structure.md +10 -10
- package/{get-shit-done → gsd-core}/templates/copilot-instructions.md +1 -1
- package/{get-shit-done → gsd-core}/templates/phase-prompt.md +10 -10
- package/gsd-core/workflows/_runtime-launcher.snippet.sh +1 -0
- package/{get-shit-done → gsd-core}/workflows/add-backlog.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/add-phase.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/add-tests.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/add-todo.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/ai-integration-phase.md +4 -4
- package/{get-shit-done → gsd-core}/workflows/audit-fix.md +2 -2
- package/{get-shit-done → gsd-core}/workflows/audit-milestone.md +3 -1
- package/{get-shit-done → gsd-core}/workflows/audit-uat.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/autonomous.md +10 -8
- package/{get-shit-done → gsd-core}/workflows/check-todos.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/cleanup.md +44 -4
- package/{get-shit-done → gsd-core}/workflows/code-review-fix.md +4 -4
- package/{get-shit-done → gsd-core}/workflows/code-review.md +6 -4
- package/{get-shit-done → gsd-core}/workflows/complete-milestone.md +2 -2
- package/{get-shit-done → gsd-core}/workflows/debug.md +7 -2
- package/{get-shit-done → gsd-core}/workflows/diagnose-issues.md +6 -2
- package/{get-shit-done → gsd-core}/workflows/discovery-phase.md +5 -5
- package/{get-shit-done → gsd-core}/workflows/discuss-phase/modes/advisor.md +5 -5
- package/{get-shit-done → gsd-core}/workflows/discuss-phase/modes/auto.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/discuss-phase/modes/chain.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/discuss-phase/modes/power.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/discuss-phase-assumptions.md +4 -4
- package/{get-shit-done → gsd-core}/workflows/discuss-phase.md +6 -6
- package/{get-shit-done → gsd-core}/workflows/do.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/docs-update.md +19 -5
- package/{get-shit-done → gsd-core}/workflows/edit-phase.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/eval-review.md +3 -3
- package/{get-shit-done → gsd-core}/workflows/execute-phase/steps/codebase-drift-gate.md +16 -3
- package/{get-shit-done → gsd-core}/workflows/execute-phase/steps/post-merge-gate.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/execute-phase.md +89 -57
- package/{get-shit-done → gsd-core}/workflows/execute-plan.md +8 -8
- package/{get-shit-done → gsd-core}/workflows/explore.md +5 -3
- package/{get-shit-done → gsd-core}/workflows/extract-learnings.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/forensics.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/graduation.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/health.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/help/modes/default.md +3 -3
- package/{get-shit-done → gsd-core}/workflows/help/modes/full.md +6 -6
- package/{get-shit-done → gsd-core}/workflows/import.md +3 -1
- package/{get-shit-done → gsd-core}/workflows/ingest-docs.md +5 -5
- package/{get-shit-done → gsd-core}/workflows/insert-phase.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/list-workspaces.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/manager.md +3 -3
- package/{get-shit-done → gsd-core}/workflows/map-codebase.md +3 -1
- package/{get-shit-done → gsd-core}/workflows/milestone-summary.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/mvp-phase.md +7 -7
- package/{get-shit-done → gsd-core}/workflows/new-milestone.md +5 -5
- package/{get-shit-done → gsd-core}/workflows/new-project.md +8 -8
- package/{get-shit-done → gsd-core}/workflows/new-workspace.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/next.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/pause-work.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/plan-milestone-gaps.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/plan-phase.md +29 -28
- package/{get-shit-done → gsd-core}/workflows/plan-review-convergence.md +10 -10
- package/{get-shit-done → gsd-core}/workflows/plant-seed.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/profile-user.md +11 -11
- package/{get-shit-done → gsd-core}/workflows/progress.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/quick.md +7 -29
- package/{get-shit-done → gsd-core}/workflows/reapply-patches.md +2 -2
- package/{get-shit-done → gsd-core}/workflows/remove-phase.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/remove-workspace.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/resume-project.md +2 -2
- package/{get-shit-done → gsd-core}/workflows/review.md +110 -2
- package/{get-shit-done → gsd-core}/workflows/scan.md +3 -1
- package/{get-shit-done → gsd-core}/workflows/secure-phase.md +5 -3
- package/{get-shit-done → gsd-core}/workflows/settings-advanced.md +196 -6
- package/{get-shit-done → gsd-core}/workflows/settings-integrations.md +2 -2
- package/{get-shit-done → gsd-core}/workflows/settings.md +16 -2
- package/{get-shit-done → gsd-core}/workflows/ship.md +56 -4
- package/{get-shit-done → gsd-core}/workflows/sketch-wrap-up.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/sketch.md +5 -5
- package/{get-shit-done → gsd-core}/workflows/spec-phase.md +2 -2
- package/{get-shit-done → gsd-core}/workflows/spike-wrap-up.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/spike.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/stats.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/sync-skills.md +3 -3
- package/{get-shit-done → gsd-core}/workflows/thread.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/transition.md +2 -2
- package/{get-shit-done → gsd-core}/workflows/ui-phase.md +5 -5
- package/{get-shit-done → gsd-core}/workflows/ui-review.md +3 -3
- package/{get-shit-done → gsd-core}/workflows/ultraplan-phase.md +1 -1
- package/{get-shit-done → gsd-core}/workflows/undo.md +2 -2
- package/{get-shit-done → gsd-core}/workflows/update.md +41 -16
- package/{get-shit-done → gsd-core}/workflows/validate-phase.md +5 -3
- package/{get-shit-done → gsd-core}/workflows/verify-phase.md +4 -4
- package/{get-shit-done → gsd-core}/workflows/verify-work.md +7 -7
- package/hooks/dist/gsd-check-update-worker.js +16 -3
- package/hooks/dist/gsd-check-update.js +7 -5
- package/hooks/dist/gsd-context-monitor.js +2 -2
- package/hooks/dist/gsd-statusline.js +39 -21
- package/hooks/dist/gsd-update-banner.js +6 -2
- package/hooks/dist/gsd-worktree-path-guard.js +169 -0
- package/hooks/dist/managed-hooks-registry.cjs +35 -0
- package/hooks/gsd-check-update-worker.js +16 -3
- package/hooks/gsd-check-update.js +7 -5
- package/hooks/gsd-context-monitor.js +2 -2
- package/hooks/gsd-statusline.js +39 -21
- package/hooks/gsd-update-banner.js +6 -2
- package/hooks/gsd-worktree-path-guard.js +169 -0
- package/hooks/managed-hooks-registry.cjs +1 -0
- package/package.json +17 -11
- package/scripts/affected-tests-lib.cjs +1 -1
- package/scripts/base64-scan.sh +12 -0
- package/scripts/build-hooks.js +5 -1
- package/scripts/changeset/cli.cjs +2 -2
- package/scripts/changeset/github-release-notes.cjs +1 -1
- package/scripts/changeset/lint.cjs +1 -1
- package/scripts/check-alias-drift.cjs +8 -8
- package/scripts/check-env.cjs +5 -1
- package/scripts/ci-test-scope.cjs +34 -9
- package/scripts/command-contract-helpers.cjs +1 -1
- package/scripts/fix-slash-commands.cjs +5 -5
- package/scripts/gen-inventory-manifest.cjs +3 -3
- package/scripts/generate-package-identity.cjs +28 -7
- package/scripts/lib/allowlist-ratchet.cjs +136 -0
- package/scripts/lint-command-contract.cjs +1 -1
- package/scripts/lint-legacy-dir-name.cjs +156 -0
- package/scripts/lint-package-identity-drift.cjs +8 -8
- package/scripts/lint-pr-check-project-dir.cjs +0 -1
- package/scripts/lint-shell-command-projection-drift.cjs +1 -1
- package/scripts/lint-skill-deps.cjs +1 -1
- package/scripts/lint-test-file-count.allowlist.json +129 -32
- package/scripts/lint-test-file-count.cjs +85 -30
- package/scripts/mutation-matrix.cjs +219 -0
- package/scripts/prompt-injection-scan.sh +5 -1
- package/scripts/release-notes/format-github-release-notes.cjs +256 -0
- package/scripts/release-tarball-smoke.cjs +9 -9
- package/scripts/run-tests.cjs +34 -2
- package/scripts/strip-prose-atrefs.cjs +2 -2
- package/scripts/sync-runtime-launcher.cjs +2 -2
- package/scripts/verify-npm-publish.cjs +252 -0
- package/get-shit-done/bin/lib/active-workstream-store.cjs +0 -302
- package/get-shit-done/bin/lib/adr-parser.cjs +0 -394
- package/get-shit-done/bin/lib/agent-command-router.cjs +0 -65
- package/get-shit-done/bin/lib/artifacts.cjs +0 -53
- package/get-shit-done/bin/lib/audit.cjs +0 -755
- package/get-shit-done/bin/lib/check-command-router.cjs +0 -333
- package/get-shit-done/bin/lib/cjs-command-router-adapter.cjs +0 -118
- package/get-shit-done/bin/lib/clock.cjs +0 -96
- package/get-shit-done/bin/lib/clusters.cjs +0 -135
- package/get-shit-done/bin/lib/code-review-flags.cjs +0 -74
- package/get-shit-done/bin/lib/command-aliases.cjs +0 -815
- package/get-shit-done/bin/lib/command-arg-projection.cjs +0 -62
- package/get-shit-done/bin/lib/command-routing-hub.cjs +0 -388
- package/get-shit-done/bin/lib/commands.cjs +0 -1188
- package/get-shit-done/bin/lib/config-schema.cjs +0 -31
- package/get-shit-done/bin/lib/config.cjs +0 -728
- package/get-shit-done/bin/lib/context-utilization.cjs +0 -47
- package/get-shit-done/bin/lib/core.cjs +0 -2121
- package/get-shit-done/bin/lib/docs.cjs +0 -270
- package/get-shit-done/bin/lib/drift.cjs +0 -388
- package/get-shit-done/bin/lib/fallow-runner.cjs +0 -109
- package/get-shit-done/bin/lib/frontmatter.cjs +0 -389
- package/get-shit-done/bin/lib/gap-checker.cjs +0 -205
- package/get-shit-done/bin/lib/graphify.cjs +0 -592
- package/get-shit-done/bin/lib/gsd2-import.cjs +0 -514
- package/get-shit-done/bin/lib/init-command-router.cjs +0 -58
- package/get-shit-done/bin/lib/init.cjs +0 -2112
- package/get-shit-done/bin/lib/install-profiles.cjs +0 -603
- package/get-shit-done/bin/lib/installer-migration-authoring.cjs +0 -117
- package/get-shit-done/bin/lib/installer-migration-report.cjs +0 -354
- package/get-shit-done/bin/lib/installer-migrations/000-first-time-baseline.cjs +0 -220
- package/get-shit-done/bin/lib/installer-migrations/001-legacy-orphan-files.cjs +0 -41
- package/get-shit-done/bin/lib/installer-migrations/002-codex-legacy-hooks-json.cjs +0 -80
- package/get-shit-done/bin/lib/installer-migrations.cjs +0 -778
- package/get-shit-done/bin/lib/intel.cjs +0 -708
- package/get-shit-done/bin/lib/learnings.cjs +0 -421
- package/get-shit-done/bin/lib/milestone.cjs +0 -314
- package/get-shit-done/bin/lib/model-catalog.cjs +0 -212
- package/get-shit-done/bin/lib/model-profiles.cjs +0 -31
- package/get-shit-done/bin/lib/observability/event.cjs +0 -82
- package/get-shit-done/bin/lib/observability/logger.cjs +0 -174
- package/get-shit-done/bin/lib/phase-command-router.cjs +0 -191
- package/get-shit-done/bin/lib/phase-lifecycle.cjs +0 -80
- package/get-shit-done/bin/lib/phase.cjs +0 -1607
- package/get-shit-done/bin/lib/phases-command-router.cjs +0 -39
- package/get-shit-done/bin/lib/planning-workspace.cjs +0 -238
- package/get-shit-done/bin/lib/profile-output.cjs +0 -1141
- package/get-shit-done/bin/lib/profile-pipeline.cjs +0 -539
- package/get-shit-done/bin/lib/project-root.cjs +0 -112
- package/get-shit-done/bin/lib/prompt-budget.cjs +0 -399
- package/get-shit-done/bin/lib/review-reviewer-selection.cjs +0 -125
- package/get-shit-done/bin/lib/roadmap-command-router.cjs +0 -28
- package/get-shit-done/bin/lib/roadmap.cjs +0 -650
- package/get-shit-done/bin/lib/runtime-artifact-layout.cjs +0 -301
- package/get-shit-done/bin/lib/runtime-homes.cjs +0 -222
- package/get-shit-done/bin/lib/runtime-name-policy.cjs +0 -83
- package/get-shit-done/bin/lib/runtime-slash.cjs +0 -112
- package/get-shit-done/bin/lib/secrets.cjs +0 -32
- package/get-shit-done/bin/lib/security.cjs +0 -600
- package/get-shit-done/bin/lib/semver-compare.cjs +0 -35
- package/get-shit-done/bin/lib/shell-command-projection.cjs +0 -500
- package/get-shit-done/bin/lib/state-command-router.cjs +0 -252
- package/get-shit-done/bin/lib/state.cjs +0 -2038
- package/get-shit-done/bin/lib/surface.cjs +0 -470
- package/get-shit-done/bin/lib/task-command-router.cjs +0 -81
- package/get-shit-done/bin/lib/template.cjs +0 -228
- package/get-shit-done/bin/lib/uat.cjs +0 -289
- package/get-shit-done/bin/lib/update-context.cjs +0 -209
- package/get-shit-done/bin/lib/validate-command-router.cjs +0 -83
- package/get-shit-done/bin/lib/validate.cjs +0 -92
- package/get-shit-done/bin/lib/verify-command-router.cjs +0 -40
- package/get-shit-done/bin/lib/verify.cjs +0 -1511
- package/get-shit-done/bin/lib/workstream-inventory.cjs +0 -146
- package/get-shit-done/bin/lib/workstream.cjs +0 -389
- package/get-shit-done/bin/lib/worktree-safety.cjs +0 -985
- package/get-shit-done/workflows/_runtime-launcher.snippet.sh +0 -1
- package/scripts/lint-no-source-grep-extras.cjs +0 -81
- package/scripts/lint-no-source-grep.cjs +0 -174
- package/scripts/lint-shared-module-handsync.cjs +0 -388
- package/scripts/shared-module-handsync-allowlist.json +0 -183
- /package/{get-shit-done → gsd-core}/bin/shared/runtime-aliases.manifest.json +0 -0
- /package/{get-shit-done → gsd-core}/bin/verify-reapply-patches.cjs +0 -0
- /package/{get-shit-done → gsd-core}/contexts/dev.md +0 -0
- /package/{get-shit-done → gsd-core}/contexts/research.md +0 -0
- /package/{get-shit-done → gsd-core}/contexts/review.md +0 -0
- /package/{get-shit-done → gsd-core}/references/agent-contracts.md +0 -0
- /package/{get-shit-done → gsd-core}/references/ai-evals.md +0 -0
- /package/{get-shit-done → gsd-core}/references/ai-frameworks.md +0 -0
- /package/{get-shit-done → gsd-core}/references/autonomous-smart-discuss.md +0 -0
- /package/{get-shit-done → gsd-core}/references/common-bug-patterns.md +0 -0
- /package/{get-shit-done → gsd-core}/references/context-budget.md +0 -0
- /package/{get-shit-done → gsd-core}/references/continuation-format.md +0 -0
- /package/{get-shit-done → gsd-core}/references/debugger-philosophy.md +0 -0
- /package/{get-shit-done → gsd-core}/references/decimal-phase-calculation.md +0 -0
- /package/{get-shit-done → gsd-core}/references/doc-conflict-engine.md +0 -0
- /package/{get-shit-done → gsd-core}/references/domain-probes.md +0 -0
- /package/{get-shit-done → gsd-core}/references/execute-mvp-tdd.md +0 -0
- /package/{get-shit-done → gsd-core}/references/executor-examples.md +0 -0
- /package/{get-shit-done → gsd-core}/references/gate-prompts.md +0 -0
- /package/{get-shit-done → gsd-core}/references/gates.md +0 -0
- /package/{get-shit-done → gsd-core}/references/git-integration.md +0 -0
- /package/{get-shit-done → gsd-core}/references/git-planning-commit.md +0 -0
- /package/{get-shit-done → gsd-core}/references/ios-scaffold.md +0 -0
- /package/{get-shit-done → gsd-core}/references/mandatory-initial-read.md +0 -0
- /package/{get-shit-done → gsd-core}/references/model-profiles.md +0 -0
- /package/{get-shit-done → gsd-core}/references/phase-argument-parsing.md +0 -0
- /package/{get-shit-done → gsd-core}/references/planner-antipatterns.md +0 -0
- /package/{get-shit-done → gsd-core}/references/planner-chunked.md +0 -0
- /package/{get-shit-done → gsd-core}/references/planner-gap-closure.md +0 -0
- /package/{get-shit-done → gsd-core}/references/planner-interface-context.md +0 -0
- /package/{get-shit-done → gsd-core}/references/planner-reviews.md +0 -0
- /package/{get-shit-done → gsd-core}/references/planner-revision.md +0 -0
- /package/{get-shit-done → gsd-core}/references/planner-source-audit.md +0 -0
- /package/{get-shit-done → gsd-core}/references/planning-config.md +0 -0
- /package/{get-shit-done → gsd-core}/references/project-skills-discovery.md +0 -0
- /package/{get-shit-done → gsd-core}/references/questioning.md +0 -0
- /package/{get-shit-done → gsd-core}/references/revision-loop.md +0 -0
- /package/{get-shit-done → gsd-core}/references/scout-codebase.md +0 -0
- /package/{get-shit-done → gsd-core}/references/skeleton-template.md +0 -0
- /package/{get-shit-done → gsd-core}/references/sketch-interactivity.md +0 -0
- /package/{get-shit-done → gsd-core}/references/sketch-theme-system.md +0 -0
- /package/{get-shit-done → gsd-core}/references/sketch-tooling.md +0 -0
- /package/{get-shit-done → gsd-core}/references/sketch-variant-patterns.md +0 -0
- /package/{get-shit-done → gsd-core}/references/spidr-splitting.md +0 -0
- /package/{get-shit-done → gsd-core}/references/tdd.md +0 -0
- /package/{get-shit-done → gsd-core}/references/thinking-models-debug.md +0 -0
- /package/{get-shit-done → gsd-core}/references/thinking-models-execution.md +0 -0
- /package/{get-shit-done → gsd-core}/references/thinking-models-planning.md +0 -0
- /package/{get-shit-done → gsd-core}/references/thinking-models-research.md +0 -0
- /package/{get-shit-done → gsd-core}/references/thinking-models-verification.md +0 -0
- /package/{get-shit-done → gsd-core}/references/thinking-partner.md +0 -0
- /package/{get-shit-done → gsd-core}/references/universal-anti-patterns.md +0 -0
- /package/{get-shit-done → gsd-core}/references/user-profiling.md +0 -0
- /package/{get-shit-done → gsd-core}/references/user-story-template.md +0 -0
- /package/{get-shit-done → gsd-core}/references/verification-overrides.md +0 -0
- /package/{get-shit-done → gsd-core}/references/verify-mvp-mode.md +0 -0
- /package/{get-shit-done → gsd-core}/references/workstream-flag.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/AI-SPEC.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/DEBUG.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/SECURITY.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/UAT.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/UI-SPEC.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/VALIDATION.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/claude-md.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/codebase/architecture.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/codebase/concerns.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/codebase/conventions.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/codebase/integrations.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/codebase/stack.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/codebase/testing.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/config.json +0 -0
- /package/{get-shit-done → gsd-core}/templates/context.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/continue-here.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/debug-subagent-prompt.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/dev-preferences.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/discovery.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/discussion-log.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/milestone-archive.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/milestone.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/planner-subagent-prompt.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/project.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/requirements.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/research-project/ARCHITECTURE.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/research-project/FEATURES.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/research-project/PITFALLS.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/research-project/STACK.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/research-project/SUMMARY.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/research.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/retrospective.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/roadmap.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/spec.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/state.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/summary-complex.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/summary-minimal.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/summary-standard.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/summary.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/user-profile.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/user-setup.md +0 -0
- /package/{get-shit-done → gsd-core}/templates/verification-report.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/analyze-dependencies.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/discuss-phase/modes/all.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/discuss-phase/modes/analyze.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/discuss-phase/modes/batch.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/discuss-phase/modes/default.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/discuss-phase/modes/text.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/discuss-phase/templates/checkpoint.json +0 -0
- /package/{get-shit-done → gsd-core}/workflows/discuss-phase/templates/context.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/discuss-phase/templates/discussion-log.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/discuss-phase-power.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/execute-phase/steps/per-plan-worktree-gate.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/fast.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/help/modes/brief.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/help/modes/topic.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/help.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/inbox.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/list-phase-assumptions.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/node-repair.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/note.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/pr-branch.md +0 -0
- /package/{get-shit-done → gsd-core}/workflows/session-report.md +0 -0
package/README.pt-BR.md
CHANGED
|
@@ -1,14 +1,12 @@
|
|
|
1
|
-
> ⚠️ This is an active fork. See the [English README](README.md) for the full notice about the original repo.
|
|
2
|
-
|
|
3
1
|
<div align="center">
|
|
4
2
|
|
|
5
|
-
#
|
|
3
|
+
# GSD Core
|
|
6
4
|
|
|
7
|
-
|
|
5
|
+
**Git. Ship. Done.**
|
|
8
6
|
|
|
9
|
-
|
|
7
|
+
[English](README.md) · **Português** · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md)
|
|
10
8
|
|
|
11
|
-
**
|
|
9
|
+
**Um sistema leve de meta-prompting, engenharia de contexto e desenvolvimento orientado a especificações para Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf e muito mais.**
|
|
12
10
|
|
|
13
11
|
[](https://www.npmjs.com/package/@opengsd/gsd-core)
|
|
14
12
|
[](https://www.npmjs.com/package/@opengsd/gsd-core)
|
|
@@ -17,457 +15,92 @@
|
|
|
17
15
|
[](https://github.com/open-gsd/gsd-core)
|
|
18
16
|
[](LICENSE)
|
|
19
17
|
|
|
20
|
-
<br>
|
|
21
|
-
|
|
22
|
-
```bash
|
|
23
|
-
npx @opengsd/gsd-core@latest
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
**Funciona em Mac, Windows e Linux.**
|
|
27
|
-
|
|
28
|
-
<br>
|
|
29
|
-
|
|
30
|
-

|
|
31
|
-
|
|
32
|
-
<br>
|
|
33
|
-
|
|
34
|
-
*"Se você sabe claramente o que quer, isso VAI construir para você. Sem enrolação."*
|
|
35
|
-
|
|
36
|
-
*"Eu já usei SpecKit, OpenSpec e Taskmaster — este me deu os melhores resultados."*
|
|
37
|
-
|
|
38
|
-
*"De longe a adição mais poderosa ao meu Claude Code. Nada superengenheirado. Simplesmente faz o trabalho."*
|
|
39
|
-
|
|
40
|
-
<br>
|
|
41
|
-
|
|
42
|
-
**Confiado por engenheiros da Amazon, Google, Shopify e Webflow.**
|
|
43
|
-
|
|
44
|
-
[Por que eu criei isso](#por-que-eu-criei-isso) · [Como funciona](#como-funciona) · [Comandos](#comandos) · [Por que funciona](#por-que-funciona) · [Guia do usuário](docs/pt-BR/USER-GUIDE.md)
|
|
45
|
-
|
|
46
18
|
</div>
|
|
47
19
|
|
|
48
20
|
---
|
|
49
21
|
|
|
50
|
-
##
|
|
51
|
-
|
|
52
|
-
Sou desenvolvedor solo. Eu não escrevo código — o Claude Code escreve.
|
|
53
|
-
|
|
54
|
-
Existem outras ferramentas de desenvolvimento orientado por especificação. BMAD, Speckit... Mas quase todas parecem mais complexas do que o necessário (cerimônias de sprint, story points, sync com stakeholders, retrospectivas, fluxos Jira) ou não entendem de verdade o panorama do que você está construindo. Eu não sou uma empresa de software com 50 pessoas. Não quero teatro corporativo. Só quero construir coisas boas que funcionem.
|
|
55
|
-
|
|
56
|
-
Então eu criei o GSD. A complexidade fica no sistema, não no seu fluxo. Por trás: engenharia de contexto, formatação XML de prompts, orquestração de subagentes, gerenciamento de estado. O que você vê: alguns comandos que simplesmente funcionam.
|
|
57
|
-
|
|
58
|
-
O sistema dá ao Claude tudo que ele precisa para fazer o trabalho *e* validar o resultado. Eu confio no fluxo. Ele entrega.
|
|
59
|
-
|
|
60
|
-
— **TÂCHES**
|
|
61
|
-
|
|
62
|
-
---
|
|
63
|
-
|
|
64
|
-
Vibe coding ganhou má fama. Você descreve algo, a IA gera código, e sai um resultado inconsistente que quebra em escala.
|
|
22
|
+
## O que é o GSD Core
|
|
65
23
|
|
|
66
|
-
|
|
24
|
+
GSD Core é um framework de engenharia de contexto e desenvolvimento orientado a especificações que conduz agentes de codificação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor e mais) por meio de um ciclo de fases disciplinado. Ele resolve o [context rot](docs/pt-BR/explanation/context-engineering.md) — a degradação de qualidade que se acumula à medida que uma IA preenche sua janela de contexto — executando todo o trabalho pesado de pesquisa, planejamento e execução em subagentes com contexto limpo, mantendo sua sessão principal enxuta.
|
|
67
25
|
|
|
68
26
|
---
|
|
69
27
|
|
|
70
|
-
##
|
|
71
|
-
|
|
72
|
-
Para quem quer descrever o que precisa e receber isso construído do jeito certo — sem fingir que está rodando uma engenharia de 50 pessoas.
|
|
73
|
-
|
|
74
|
-
Quality gates embutidos capturam problemas reais: detecção de schema drift sinaliza mudanças ORM sem migrations, segurança ancora verificação a modelos de ameaça, e detecção de redução de escopo impede o planner de descartar requisitos silenciosamente.
|
|
75
|
-
|
|
76
|
-
### Destaques v1.39.0
|
|
28
|
+
## Como funciona
|
|
77
29
|
|
|
78
|
-
|
|
30
|
+
Cada marco repete o mesmo ciclo de cinco etapas, uma fase por vez:
|
|
79
31
|
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
- **Workflow manual de canary release** — `.github/workflows/canary.yml` publica builds `{base}-canary.{N}` de `@opengsd/gsd-core` e `@opengsd/gsd-sdk` na dist-tag `@canary` a partir de `dev`, sob demanda via `workflow_dispatch`.
|
|
86
|
-
- **Consolidação de skills: 86 → 59** — 4 novos skills agrupados (`capture`, `phase`, `config`, `workspace`) absorvem 31 micro-skills. 6 skills pais existentes absorvem wrap-up e sub-operações como flags: `update --sync/--reapply`, `sketch --wrap-up`, `spike --wrap-up`, `map-codebase --fast/--query`, `code-review --fix`, `progress --do/--next`. Sem perda funcional.
|
|
32
|
+
1. **Discuss** — capturar decisões de implementação antes de qualquer planejamento
|
|
33
|
+
2. **Plan** — pesquisar, decompor e verificar se o plano cabe em uma janela de contexto limpa
|
|
34
|
+
3. **Execute** — executar planos em ondas paralelas; cada executor começa com um contexto limpo de 200k tokens
|
|
35
|
+
4. **Verify** — percorrer o que foi construído; diagnosticar e corrigir antes de declarar conclusão
|
|
36
|
+
5. **Ship** — criar o PR, arquivar a fase e repetir para a próxima
|
|
87
37
|
|
|
88
38
|
---
|
|
89
39
|
|
|
90
|
-
##
|
|
91
|
-
|
|
92
|
-
```bash
|
|
93
|
-
npx @opengsd/gsd-core@latest
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
O instalador pede:
|
|
97
|
-
1. **Runtime** — Claude Code, OpenCode, Gemini, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae, Cline, ou todos
|
|
98
|
-
2. **Local** — Global (todos os projetos) ou local (apenas projeto atual)
|
|
99
|
-
|
|
100
|
-
Verifique com:
|
|
101
|
-
- Claude Code / Gemini / Copilot / Antigravity: `/gsd-help`
|
|
102
|
-
- OpenCode / Kilo / Augment / Trae: `/gsd-help`
|
|
103
|
-
- Codex: `$gsd-help`
|
|
104
|
-
- Cline: GSD instala via `.clinerules` — verifique se `.clinerules` existe
|
|
105
|
-
|
|
106
|
-
> [!NOTE]
|
|
107
|
-
> Claude Code 2.1.88+ e Codex instalam como skills (`skills/gsd-*/SKILL.md`). Cline usa `.clinerules`. O instalador lida com todos os formatos automaticamente.
|
|
108
|
-
|
|
109
|
-
> [!TIP]
|
|
110
|
-
> Para instalação a partir do código-fonte ou ambientes sem npm, consulte **[docs/manual-update.md](docs/manual-update.md)**.
|
|
111
|
-
|
|
112
|
-
### Mantendo atualizado
|
|
40
|
+
## Início rápido
|
|
113
41
|
|
|
114
42
|
```bash
|
|
115
43
|
npx @opengsd/gsd-core@latest
|
|
116
44
|
```
|
|
117
45
|
|
|
118
|
-
|
|
119
|
-
<summary><strong>Instalação não interativa (Docker, CI, Scripts)</strong></summary>
|
|
120
|
-
|
|
121
|
-
```bash
|
|
122
|
-
# Claude Code
|
|
123
|
-
npx @opengsd/gsd-core --claude --global
|
|
124
|
-
npx @opengsd/gsd-core --claude --local
|
|
125
|
-
|
|
126
|
-
# OpenCode
|
|
127
|
-
npx @opengsd/gsd-core --opencode --global
|
|
128
|
-
|
|
129
|
-
# Gemini CLI
|
|
130
|
-
npx @opengsd/gsd-core --gemini --global
|
|
131
|
-
|
|
132
|
-
# Kilo
|
|
133
|
-
npx @opengsd/gsd-core --kilo --global
|
|
134
|
-
npx @opengsd/gsd-core --kilo --local
|
|
135
|
-
|
|
136
|
-
# Codex
|
|
137
|
-
npx @opengsd/gsd-core --codex --global
|
|
138
|
-
npx @opengsd/gsd-core --codex --local
|
|
139
|
-
|
|
140
|
-
# Copilot
|
|
141
|
-
npx @opengsd/gsd-core --copilot --global
|
|
142
|
-
npx @opengsd/gsd-core --copilot --local
|
|
143
|
-
|
|
144
|
-
# Cursor
|
|
145
|
-
npx @opengsd/gsd-core --cursor --global
|
|
146
|
-
npx @opengsd/gsd-core --cursor --local
|
|
147
|
-
|
|
148
|
-
# Antigravity
|
|
149
|
-
npx @opengsd/gsd-core --antigravity --global
|
|
150
|
-
npx @opengsd/gsd-core --antigravity --local
|
|
151
|
-
|
|
152
|
-
# Augment
|
|
153
|
-
npx @opengsd/gsd-core --augment --global # Install to ~/.augment/
|
|
154
|
-
npx @opengsd/gsd-core --augment --local # Install to ./.augment/
|
|
155
|
-
|
|
156
|
-
# Trae
|
|
157
|
-
npx @opengsd/gsd-core --trae --global # Install to ~/.trae/
|
|
158
|
-
npx @opengsd/gsd-core --trae --local # Install to ./.trae/
|
|
159
|
-
|
|
160
|
-
# Cline
|
|
161
|
-
npx @opengsd/gsd-core --cline --global # Install to ~/.cline/
|
|
162
|
-
npx @opengsd/gsd-core --cline --local # Install to ./.clinerules
|
|
163
|
-
|
|
164
|
-
# Todos
|
|
165
|
-
npx @opengsd/gsd-core --all --global
|
|
166
|
-
```
|
|
167
|
-
|
|
168
|
-
Use `--global` (`-g`) ou `--local` (`-l`) para pular a pergunta de local.
|
|
169
|
-
Use `--claude`, `--opencode`, `--gemini`, `--kilo`, `--codex`, `--copilot`, `--cursor`, `--windsurf`, `--antigravity`, `--augment`, `--trae`, `--cline` ou `--all` para pular a pergunta de runtime.
|
|
46
|
+
O instalador solicita seu ambiente de execução (Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf e mais) e se deseja instalar globalmente ou localmente. O instalador é necessário para compatibilidade entre runtimes — não copie arquivos diretamente de `agents/` ou `commands/`.
|
|
170
47
|
|
|
171
|
-
|
|
48
|
+
Em outro runtime ou sem Node.js? Consulte [Instalar no seu runtime](docs/pt-BR/how-to/install-on-your-runtime.md).
|
|
172
49
|
|
|
173
|
-
|
|
50
|
+
Após a instalação, inicie seu primeiro projeto:
|
|
174
51
|
|
|
175
52
|
```bash
|
|
176
|
-
claude --dangerously-skip-permissions
|
|
177
|
-
```
|
|
178
|
-
|
|
179
|
-
> [!TIP]
|
|
180
|
-
> Esse é o modo pensado para o GSD: aprovar `date` e `git commit` 50 vezes mata a produtividade.
|
|
181
|
-
|
|
182
|
-
---
|
|
183
|
-
|
|
184
|
-
## Como funciona
|
|
185
|
-
|
|
186
|
-
> **Já tem código?** Rode `/gsd-map-codebase` primeiro para analisar stack, arquitetura, convenções e riscos.
|
|
187
|
-
|
|
188
|
-
### 1. Inicializar projeto
|
|
189
|
-
|
|
190
|
-
```
|
|
191
53
|
/gsd-new-project
|
|
192
54
|
```
|
|
193
55
|
|
|
194
|
-
|
|
195
|
-
1. **Pergunta** até entender seu objetivo
|
|
196
|
-
2. **Pesquisa** o domínio com agentes em paralelo
|
|
197
|
-
3. **Extrai requisitos** (v1, v2 e fora de escopo)
|
|
198
|
-
4. **Monta roadmap** por fases
|
|
199
|
-
|
|
200
|
-
**Cria:** `PROJECT.md`, `REQUIREMENTS.md`, `ROADMAP.md`, `STATE.md`, `.planning/research/`
|
|
201
|
-
|
|
202
|
-
### 2. Discutir fase
|
|
203
|
-
|
|
204
|
-
```
|
|
205
|
-
/gsd-discuss-phase 1
|
|
206
|
-
```
|
|
207
|
-
|
|
208
|
-
Captura suas preferências de implementação antes do planejamento.
|
|
209
|
-
|
|
210
|
-
**Cria:** `{phase_num}-CONTEXT.md`
|
|
211
|
-
|
|
212
|
-
### 3. Planejar fase
|
|
213
|
-
|
|
214
|
-
```
|
|
215
|
-
/gsd-plan-phase 1
|
|
216
|
-
```
|
|
217
|
-
|
|
218
|
-
1. Pesquisa abordagens
|
|
219
|
-
2. Cria 2-3 planos atômicos em XML
|
|
220
|
-
3. Verifica contra os requisitos
|
|
221
|
-
|
|
222
|
-
**Cria:** `{phase_num}-RESEARCH.md`, `{phase_num}-{N}-PLAN.md`
|
|
223
|
-
|
|
224
|
-
### 4. Executar fase
|
|
225
|
-
|
|
226
|
-
```
|
|
227
|
-
/gsd-execute-phase 1
|
|
228
|
-
```
|
|
229
|
-
|
|
230
|
-
1. Executa planos em ondas
|
|
231
|
-
2. Contexto novo por plano
|
|
232
|
-
3. Commit atômico por tarefa
|
|
233
|
-
4. Verifica contra objetivos
|
|
234
|
-
|
|
235
|
-
**Cria:** `{phase_num}-{N}-SUMMARY.md`, `{phase_num}-VERIFICATION.md`
|
|
236
|
-
|
|
237
|
-
### 5. Verificar trabalho
|
|
238
|
-
|
|
239
|
-
```
|
|
240
|
-
/gsd-verify-work 1
|
|
241
|
-
```
|
|
242
|
-
|
|
243
|
-
Validação manual orientada para confirmar que a feature realmente funciona como esperado.
|
|
244
|
-
|
|
245
|
-
**Cria:** `{phase_num}-UAT.md` e planos de correção se necessário
|
|
246
|
-
|
|
247
|
-
### 6. Repetir -> Entregar -> Completar
|
|
248
|
-
|
|
249
|
-
```
|
|
250
|
-
/gsd-discuss-phase 2
|
|
251
|
-
/gsd-plan-phase 2
|
|
252
|
-
/gsd-execute-phase 2
|
|
253
|
-
/gsd-verify-work 2
|
|
254
|
-
/gsd-ship 2
|
|
255
|
-
/gsd-complete-milestone
|
|
256
|
-
/gsd-new-milestone
|
|
257
|
-
```
|
|
258
|
-
|
|
259
|
-
Ou deixe o GSD decidir:
|
|
260
|
-
|
|
261
|
-
```
|
|
262
|
-
/gsd-progress --next
|
|
263
|
-
```
|
|
264
|
-
|
|
265
|
-
### Modo rápido
|
|
266
|
-
|
|
267
|
-
```
|
|
268
|
-
/gsd-quick
|
|
269
|
-
```
|
|
270
|
-
|
|
271
|
-
Para tarefas ad-hoc sem ciclo completo de planejamento.
|
|
56
|
+
É a primeira vez? Siga [Seu primeiro projeto](docs/pt-BR/tutorials/your-first-project.md) para um passo a passo guiado, desde a instalação até a primeira fase entregue.
|
|
272
57
|
|
|
273
58
|
---
|
|
274
59
|
|
|
275
|
-
##
|
|
60
|
+
## Documentação
|
|
276
61
|
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|---------|-------|
|
|
281
|
-
| `PROJECT.md` | Visão do projeto |
|
|
282
|
-
| `research/` | Conhecimento do ecossistema |
|
|
283
|
-
| `REQUIREMENTS.md` | Escopo v1/v2 |
|
|
284
|
-
| `ROADMAP.md` | Direção e progresso |
|
|
285
|
-
| `STATE.md` | Memória entre sessões |
|
|
286
|
-
| `PLAN.md` | Tarefa atômica com XML |
|
|
287
|
-
| `SUMMARY.md` | O que mudou |
|
|
288
|
-
| `todos/` | Ideias para depois |
|
|
289
|
-
| `threads/` | Contexto persistente |
|
|
290
|
-
| `seeds/` | Ideias para próximos marcos |
|
|
291
|
-
|
|
292
|
-
### Formato XML de prompt
|
|
293
|
-
|
|
294
|
-
```xml
|
|
295
|
-
<task type="auto">
|
|
296
|
-
<name>Create login endpoint</name>
|
|
297
|
-
<files>src/app/api/auth/login/route.ts</files>
|
|
298
|
-
<action>
|
|
299
|
-
Use jose for JWT (not jsonwebtoken - CommonJS issues).
|
|
300
|
-
Validate credentials against users table.
|
|
301
|
-
Return httpOnly cookie on success.
|
|
302
|
-
</action>
|
|
303
|
-
<verify>curl -X POST localhost:3000/api/auth/login returns 200 + Set-Cookie</verify>
|
|
304
|
-
<done>Valid credentials return cookie, invalid return 401</done>
|
|
305
|
-
</task>
|
|
306
|
-
```
|
|
62
|
+
**Tutoriais** — aprendendo na prática:
|
|
63
|
+
- [Seu primeiro projeto](docs/pt-BR/tutorials/your-first-project.md)
|
|
64
|
+
- [Integrar uma base de código existente](docs/pt-BR/tutorials/onboarding-an-existing-codebase.md)
|
|
307
65
|
|
|
308
|
-
|
|
66
|
+
**Guias práticos** — receitas orientadas a tarefas:
|
|
67
|
+
- [Instalar no seu runtime](docs/pt-BR/how-to/install-on-your-runtime.md)
|
|
68
|
+
- [Planejar uma fase](docs/pt-BR/how-to/plan-a-phase.md)
|
|
69
|
+
- [Verificar e entregar](docs/pt-BR/how-to/verify-and-ship.md)
|
|
70
|
+
- … [ver todos os guias práticos](docs/pt-BR/README.md#how-to-guides)
|
|
309
71
|
|
|
310
|
-
|
|
72
|
+
**Referência** — informações autoritativas:
|
|
73
|
+
- [Comandos](docs/pt-BR/COMMANDS.md)
|
|
74
|
+
- [Configuração](docs/pt-BR/CONFIGURATION.md)
|
|
75
|
+
- [Ferramentas CLI](docs/pt-BR/CLI-TOOLS.md)
|
|
311
76
|
|
|
312
|
-
|
|
77
|
+
**Explicação** — conceitos e decisões de design:
|
|
78
|
+
- [Engenharia de contexto](docs/pt-BR/explanation/context-engineering.md)
|
|
79
|
+
- [O ciclo de fases](docs/pt-BR/explanation/the-phase-loop.md)
|
|
80
|
+
- [Arquitetura](docs/pt-BR/ARCHITECTURE.md)
|
|
313
81
|
|
|
314
|
-
|
|
82
|
+
Índice completo: [docs/pt-BR/README.md](docs/pt-BR/README.md). Outros idiomas: [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md) · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md).
|
|
315
83
|
|
|
316
84
|
---
|
|
317
85
|
|
|
318
|
-
##
|
|
319
|
-
|
|
320
|
-
### Fluxo principal
|
|
321
|
-
|
|
322
|
-
| Comando | O que faz |
|
|
323
|
-
|---------|-----------|
|
|
324
|
-
| `/gsd-new-project [--auto]` | Inicializa projeto completo |
|
|
325
|
-
| `/gsd-discuss-phase [N] [--auto] [--analyze] [--chain]` | Captura decisões antes do plano (`--chain` encadeia automaticamente em plan+execute) |
|
|
326
|
-
| `/gsd-plan-phase [N] [--auto] [--reviews]` | Pesquisa + plano + validação |
|
|
327
|
-
| `/gsd-execute-phase <N>` | Executa planos em ondas paralelas |
|
|
328
|
-
| `/gsd-verify-work [N]` | UAT manual |
|
|
329
|
-
| `/gsd-ship [N] [--draft]` | Cria PR da fase validada |
|
|
330
|
-
| `/gsd-progress --next` | Avança automaticamente para o próximo passo |
|
|
331
|
-
| `/gsd-fast <text>` | Tarefas triviais sem planejamento |
|
|
332
|
-
| `/gsd-complete-milestone` | Fecha o marco e marca release |
|
|
333
|
-
| `/gsd-new-milestone [name]` | Inicia próximo marco |
|
|
334
|
-
|
|
335
|
-
### Qualidade e utilidades
|
|
336
|
-
|
|
337
|
-
| Comando | O que faz |
|
|
338
|
-
|---------|-----------|
|
|
339
|
-
| `/gsd-review` | Peer review com múltiplas IAs |
|
|
340
|
-
| `/gsd-pr-branch` | Cria branch limpa para PR |
|
|
341
|
-
| `/gsd-settings` | Configura perfis e agentes |
|
|
342
|
-
| `/gsd-config --profile <profile>` | Troca perfil (quality/balanced/budget/inherit) |
|
|
343
|
-
| `/gsd-quick [--full] [--discuss] [--research]` | Execução rápida com garantias do GSD (`--full` ativa todas as etapas, `--validate` ativa apenas verificação) |
|
|
344
|
-
| `/gsd-health [--repair]` | Verifica e repara `.planning/` |
|
|
345
|
-
|
|
346
|
-
> Para a lista completa de comandos e opções, use `/gsd-help`.
|
|
347
|
-
|
|
348
|
-
---
|
|
349
|
-
|
|
350
|
-
## Configuração
|
|
351
|
-
|
|
352
|
-
As configurações do projeto ficam em `.planning/config.json`.
|
|
353
|
-
Você pode configurar no `/gsd-new-project` ou ajustar depois com `/gsd-settings`.
|
|
354
|
-
|
|
355
|
-
### Ajustes principais
|
|
356
|
-
|
|
357
|
-
| Configuração | Opções | Padrão | Controle |
|
|
358
|
-
|--------------|--------|--------|----------|
|
|
359
|
-
| `mode` | `yolo`, `interactive` | `interactive` | Autoaprovar vs confirmar etapas |
|
|
360
|
-
| `granularity` | `coarse`, `standard`, `fine` | `standard` | Granularidade de fases/planos |
|
|
361
|
-
|
|
362
|
-
### Perfis de modelo
|
|
363
|
-
|
|
364
|
-
| Perfil | Planejamento | Execução | Verificação |
|
|
365
|
-
|--------|--------------|----------|-------------|
|
|
366
|
-
| `quality` | Opus | Opus | Sonnet |
|
|
367
|
-
| `balanced` | Opus | Sonnet | Sonnet |
|
|
368
|
-
| `budget` | Sonnet | Sonnet | Haiku |
|
|
369
|
-
| `inherit` | Inherit | Inherit | Inherit |
|
|
370
|
-
|
|
371
|
-
Troca rápida:
|
|
372
|
-
```
|
|
373
|
-
/gsd-config --profile budget
|
|
374
|
-
```
|
|
375
|
-
|
|
376
|
-
---
|
|
377
|
-
|
|
378
|
-
## Segurança
|
|
379
|
-
|
|
380
|
-
### Endurecimento embutido
|
|
381
|
-
|
|
382
|
-
O GSD inclui proteções como:
|
|
383
|
-
- prevenção de path traversal
|
|
384
|
-
- detecção de prompt injection
|
|
385
|
-
- validação de argumentos de shell
|
|
386
|
-
- parsing seguro de JSON
|
|
387
|
-
- scanner de injeção para CI
|
|
388
|
-
|
|
389
|
-
### Protegendo arquivos sensíveis
|
|
390
|
-
|
|
391
|
-
Adicione padrões sensíveis ao deny list do Claude Code:
|
|
392
|
-
|
|
393
|
-
```json
|
|
394
|
-
{
|
|
395
|
-
"permissions": {
|
|
396
|
-
"deny": [
|
|
397
|
-
"Read(.env)",
|
|
398
|
-
"Read(.env.*)",
|
|
399
|
-
"Read(**/secrets/*)",
|
|
400
|
-
"Read(**/*credential*)",
|
|
401
|
-
"Read(**/*.pem)",
|
|
402
|
-
"Read(**/*.key)"
|
|
403
|
-
]
|
|
404
|
-
}
|
|
405
|
-
}
|
|
406
|
-
```
|
|
407
|
-
|
|
408
|
-
---
|
|
409
|
-
|
|
410
|
-
## Solução de problemas
|
|
411
|
-
|
|
412
|
-
**Comandos não apareceram após instalar?**
|
|
413
|
-
- Reinicie o runtime
|
|
414
|
-
- Verifique se os arquivos foram instalados no diretório correto
|
|
415
|
-
|
|
416
|
-
**Comandos não funcionam como esperado?**
|
|
417
|
-
- Rode `/gsd-help`
|
|
418
|
-
- Reinstale com `npx @opengsd/gsd-core@latest`
|
|
419
|
-
|
|
420
|
-
**Em Docker/container?**
|
|
421
|
-
- Defina `CLAUDE_CONFIG_DIR` antes da instalação:
|
|
422
|
-
|
|
423
|
-
```bash
|
|
424
|
-
CLAUDE_CONFIG_DIR=/home/youruser/.claude npx @opengsd/gsd-core --global
|
|
425
|
-
```
|
|
86
|
+
## Por que funciona
|
|
426
87
|
|
|
427
|
-
|
|
88
|
+
A maioria das configurações de codificação com IA falha em escala porque o inchaço de contexto degrada silenciosamente a qualidade da saída, não há memória compartilhada entre sessões e nada verifica se o código realmente funciona. O GSD Core resolve os três problemas: o trabalho pesado é executado em subagentes com contexto limpo, artefatos estruturados como `STATE.md` e `CONTEXT.md` sobrevivem às fronteiras de sessão, e a etapa de verificação percorre o que foi construído e gera planos de correção antes de uma fase ser declarada concluída. Consulte [docs/pt-BR/explanation/context-engineering.md](docs/pt-BR/explanation/context-engineering.md) para o raciocínio completo.
|
|
428
89
|
|
|
429
|
-
|
|
430
|
-
# Instalações globais
|
|
431
|
-
npx @opengsd/gsd-core --claude --global --uninstall
|
|
432
|
-
npx @opengsd/gsd-core --opencode --global --uninstall
|
|
433
|
-
npx @opengsd/gsd-core --gemini --global --uninstall
|
|
434
|
-
npx @opengsd/gsd-core --kilo --global --uninstall
|
|
435
|
-
npx @opengsd/gsd-core --codex --global --uninstall
|
|
436
|
-
npx @opengsd/gsd-core --copilot --global --uninstall
|
|
437
|
-
npx @opengsd/gsd-core --cursor --global --uninstall
|
|
438
|
-
npx @opengsd/gsd-core --antigravity --global --uninstall
|
|
439
|
-
npx @opengsd/gsd-core --augment --global --uninstall
|
|
440
|
-
npx @opengsd/gsd-core --trae --global --uninstall
|
|
441
|
-
npx @opengsd/gsd-core --cline --global --uninstall
|
|
442
|
-
|
|
443
|
-
# Instalações locais (projeto atual)
|
|
444
|
-
npx @opengsd/gsd-core --claude --local --uninstall
|
|
445
|
-
npx @opengsd/gsd-core --opencode --local --uninstall
|
|
446
|
-
npx @opengsd/gsd-core --gemini --local --uninstall
|
|
447
|
-
npx @opengsd/gsd-core --kilo --local --uninstall
|
|
448
|
-
npx @opengsd/gsd-core --codex --local --uninstall
|
|
449
|
-
npx @opengsd/gsd-core --copilot --local --uninstall
|
|
450
|
-
npx @opengsd/gsd-core --cursor --local --uninstall
|
|
451
|
-
npx @opengsd/gsd-core --antigravity --local --uninstall
|
|
452
|
-
npx @opengsd/gsd-core --augment --local --uninstall
|
|
453
|
-
npx @opengsd/gsd-core --trae --local --uninstall
|
|
454
|
-
npx @opengsd/gsd-core --cline --local --uninstall
|
|
455
|
-
```
|
|
90
|
+
Problemas? Consulte [docs/pt-BR/how-to/recover-and-troubleshoot.md](docs/pt-BR/how-to/recover-and-troubleshoot.md).
|
|
456
91
|
|
|
457
92
|
---
|
|
458
93
|
|
|
459
|
-
##
|
|
460
|
-
|
|
461
|
-
OpenCode, Gemini CLI, Kilo e Codex agora são suportados nativamente via `npx @opengsd/gsd-core`.
|
|
94
|
+
## Comunidade
|
|
462
95
|
|
|
463
|
-
| Projeto | Plataforma |
|
|
464
|
-
|
|
465
|
-
| [gsd-opencode](https://github.com/rokicool/gsd-opencode) |
|
|
466
|
-
|
|
|
96
|
+
| Projeto | Plataforma |
|
|
97
|
+
|---------|----------|
|
|
98
|
+
| [gsd-opencode](https://github.com/rokicool/gsd-opencode) | Port original para OpenCode |
|
|
99
|
+
| [Discord](https://discord.gg/mYgfVNfA2r) | Suporte da comunidade |
|
|
467
100
|
|
|
468
101
|
---
|
|
469
102
|
|
|
470
|
-
##
|
|
103
|
+
## Histórico de estrelas
|
|
471
104
|
|
|
472
105
|
<a href="https://star-history.com/#open-gsd/gsd-core&Date">
|
|
473
106
|
<picture>
|
|
@@ -481,12 +114,12 @@ OpenCode, Gemini CLI, Kilo e Codex agora são suportados nativamente via `npx @o
|
|
|
481
114
|
|
|
482
115
|
## Licença
|
|
483
116
|
|
|
484
|
-
Licença MIT.
|
|
117
|
+
Licença MIT. Consulte [LICENSE](LICENSE) para detalhes.
|
|
485
118
|
|
|
486
119
|
---
|
|
487
120
|
|
|
488
121
|
<div align="center">
|
|
489
122
|
|
|
490
|
-
**Claude Code é poderoso.
|
|
123
|
+
**Claude Code é poderoso. GSD Core o torna confiável.**
|
|
491
124
|
|
|
492
125
|
</div>
|