SDD Lifecycle

The "North Star" for your project. Before any feature work begins, the TPO executes a project-wide scan to establish architectural guardrails. This locks metadata conventions into the .specify/memory/constitution.md file.

Strategic Requirement Engineering. The TPO writes a functional specification that defines WHAT the feature must do from a business perspective, located in the specs/ directory.

The Reality Check. The Architect and TPO run a discovery cycle to see if the active Salesforce Org has any manual changes (Drift) that conflict with the specification.

Technical Architecture Blueprinting. The Architect generates the implementation strategy, defining exactly which classes, fields, and flows will be created.

Atomic Decomposition. The technical plan is broken down into self-contained story files in .specify/stories/ for easier execution.

Human-in-the-Loop Validation. No automated code is written until a human confirms that the planned architecture perfectly serves the business intent.

Autonomous Building. The Developer executes the story files. SFSpeckit writes code, runs tests, fixes errors, and iterates until the technical plan is fulfilled.

Quality Evidence. The Developer generates a formal verification report including code analyzer results and coverage heatmaps.

The Contribution Gate. Automated Pull Request preparation via GitHub CLI, aggregating implementation details and verification evidence.

Persona-Based Validation. The QA team executes multi-persona validation scripts, ensuring security matrices and FLS are enforced.

Business Value Sign-off. The Business Product Owner (BPO) verifies that the functional objective has been correctly achieved in staging.

Platform Sanity. A full suite of regression tests is executed to ensure no breaking changes were introduced into existing features.

Health Dashboard. Real-time project health metrics across all stories are visualized to determine if the feature is ready for release.

Promotion Gateway. Evidence-based release promotion across the landscape (Dev -> QA -> UAT -> Prod).

Final Delivery. Automatically aggregates story summaries and testing results into a business-ready Release Note.