Spec-First 30-Day Adoption Plan

This plan provides a phased approach to adopting SEA™ Forge governance across your organization.

Overview

Week 1: Foundation

Day 1-2: Environment Setup

Tasks:

1
2
3
4
5
6
7
8
9
# Clone and configure
git clone https://github.com/GodSpeedAI/SEA™.git
cd SEA™ && cp .env.example .env

# Verify environment
just doctor

# Start services
docker-compose up -d

Success Criteria:

• just doctor passes
• All containers running

Day 3-5: Team Training

Tasks:

• Complete Fundamentals track (2 hours/person)
• Assign role-specific tracks
• Schedule hands-on sessions

Materials:

• Enablement Curriculum

Success Criteria:

• Team completed Fundamentals
• Can run core just commands

Day 6-7: Initial Policies

Tasks:

• Review existing specs
• Author 3-5 governance policies
• Validate with just sea-validate

Success Criteria:

• Policies authored and validated
• AGC reviewed and approved

Week 2: Configuration

Day 8-10: GovernedSpeed™ Setup

Tasks:

• Configure Policy Gateway filters
• Enable Evidence Service
• Test with sample inputs

Materials:

• GovernedSpeed™ Integration

Success Criteria:

• Policy Gateway filtering active
• Evidence Service logging
• Test prompts correctly handled

Day 11-12: Policy Gateway Tuning

Tasks:

• Adjust filter sensitivity
• Add domain-specific rules
• Document configuration

Success Criteria:

• False positive rate acceptable
• All critical filters active

Day 13-14: Evidence Service Verification

Tasks:

• Test log queries
• Verify integrity verification
• Configure retention

Success Criteria:

• Can retrieve logs
• Merkle verification works

Week 3: Integration

Day 15-17: CI/CD Integration

Tasks:

1
2
3
# Add to CI pipeline
- name: Spec Validation
  run: just spec-guard

Success Criteria:

• spec-guard runs in CI
• Merge blocking on failure

Day 18-19: Drift Detection

Tasks:

• Enable drift detection
• Test with intentional change
• Document remediation

Success Criteria:

• Drift detected and blocked
• Team knows remediation process

Day 20-21: Monitoring Setup

Tasks:

• Configure dashboards
• Set up alerts
• Define KPIs

Success Criteria:

• Dashboard accessible
• Critical alerts configured

Week 4: Adoption

Day 22-24: Pilot Project

Tasks:

• Select moderate-complexity initiative
• Apply full spec-first workflow
• Document lessons learned

Workflow:

1
2
3
4
5
6
just /spec adr
just /spec prd
just /spec sds
just sea-validate <file>
just pipeline <context>
just ci

Success Criteria:

• Pilot uses governance end-to-end
• All validations pass

Day 25-27: Documentation

Tasks:

• Finalize governance policies
• Update team procedures
• Create runbooks

Success Criteria:

• Policies finalized
• Procedures documented

Day 28-30: Review & Plan

Tasks:

• Conduct retrospective
• Measure success metrics
• Plan next phase

Success Metrics: | Metric | Target | Actual | |——–|——–|——–| | spec-guard pass rate | 100% | | | Policy Gateway active | Yes | | | Evidence Service active | Yes | | | Drift detection enabled | Yes | | | Pilot completed | Yes | |

Post-30 Days

Month 2: Expansion

• Roll out to additional projects
• Complete remaining training tracks
• Refine policies based on learnings

Month 3: Optimization

• Tune Policy Gateway
• Automate common patterns
• First governance audit

Ongoing

• Quarterly policy reviews
• Continuous training
• Regulatory alignment updates

Quick Reference

Daily Checks

1
2
just doctor          # Environment health
just spec-guard      # Spec validation

Weekly Reviews

• Policy violation summary
• Drift detection status
• Evidence Service health

Key Contacts

• Governance Lead: [Assign]
• Technical Lead: [Assign]
• Compliance Lead: [Assign]