3.2 KiB
3.2 KiB
phase, slug, status, nyquist_compliant, wave_0_complete, created
| phase | slug | status | nyquist_compliant | wave_0_complete | created |
|---|---|---|---|---|---|
| 1 | setup-git-foundation | draft | false | false | 2026-03-24 |
Phase 1 — Validation Strategy
Per-phase validation contract for feedback sampling during execution.
Test Infrastructure
| Property | Value |
|---|---|
| Framework | Bash script testing |
| Config file | none — Wave 0 installs |
| Quick run command | ./scripts/check-env.sh |
| Full suite command | `./scripts/check-env.sh && ./scripts/validate-compose.sh labs/lab-01-iam/docker-compose.yml 2>/dev/null |
| Estimated runtime | ~5 seconds |
Sampling Rate
- After every task commit: Run
./scripts/check-env.sh - After every plan wave: Run full suite command
- Before
/gsd:verify-work: Full suite must be green - Max feedback latency: 10 seconds
Per-Task Verification Map
| Task ID | Plan | Wave | Requirement | Test Type | Automated Command | File Exists | Status |
|---|---|---|---|---|---|---|---|
| 01-01-01 | 01 | 1 | SETUP-01 | script | ./scripts/check-env.sh |
✅ W0 | ⬜ pending |
| 01-01-02 | 01 | 1 | SETUP-02 | script | ./scripts/check-env.sh |
✅ W0 | ⬜ pending |
| 01-01-03 | 01 | 1 | SETUP-03 | script | ./scripts/check-env.sh |
✅ W0 | ⬜ pending |
| 01-01-04 | 01 | 1 | SETUP-04 | script | ./scripts/check-env.sh |
✅ W0 | ⬜ pending |
| 01-01-05 | 02 | 1 | SETUP-05 | script | ./scripts/reset-env.sh --dry-run |
✅ W0 | ⬜ pending |
| 01-02-01 | 02 | 1 | INF-05 | script | ./scripts/validate-compose.sh |
✅ W0 | ⬜ pending |
| 01-03-01 | 03 | 2 | GIT-04 | file | test -f README.md |
✅ W0 | ⬜ pending |
| 01-03-02 | 03 | 2 | GIT-05 | dir | test -d labs && test -d how-to-guides && test -d reference |
✅ W0 | ⬜ pending |
Status: ⬜ pending · ✅ green · ❌ red · ⚠️ flaky
Wave 0 Requirements
scripts/check-env.sh— Verifies Docker Engine >= 24.0, Compose V2, network utilitiesscripts/validate-compose.sh— Validates docker-compose.yml syntaxscripts/reset-env.sh— Cleans Docker containers, networks, volumesREADME.md— Project overview and setup instructionslabs/directory placeholderhow-to-guides/directory placeholderreference/directory placeholder
All scripts must be executable (chmod +x)
Manual-Only Verifications
| Behavior | Requirement | Why Manual | Test Instructions |
|---|---|---|---|
| README clarity for new students | GIT-04 | Requires human judgment | Follow README instructions literally on fresh system |
| Docker installation instructions accuracy | SETUP-01 | Depends on OS variations | Verify instructions for Ubuntu/Debian, macOS, Windows |
All core functionality has automated verification.
Validation Sign-Off
- All tasks have
<automated>verify or Wave 0 dependencies - Sampling continuity: no 3 consecutive tasks without automated verify
- Wave 0 covers all MISSING references
- No watch-mode flags
- Feedback latency < 10s
nyquist_compliant: trueset in frontmatter
Approval: pending