Sign in to create and edit playbooks. Sign In Register

Review & Commit

DSP-6 Order: #6 Elaboration Has Dependencies

Updated 3 weeks, 3 days ago

Guidance

Review & Commit

Objective

Review the generated AI IDE configuration file(s) with the user, make any requested adjustments, and commit to the repository.


Process

1. Present Generated Config for Review

Show the user the generated file(s) from DSP-05:

For each generated file, verify:

Check Criteria
Completeness All 10 sections present and populated
Accuracy Architecture matches current SAO.md
Docs Map All referenced files actually exist
Workflows All available workflows listed
Skills All available skills listed (or "none yet" noted)
Artifact Templates All templates referenced with correct paths
Conventions Coding standards match team practice
Running Locally Commands are correct and tested

2. Collect User Feedback

Ask the user:

  1. Is anything missing? — project-specific conventions, team norms, special tools?
  2. Is anything wrong? — outdated architecture, incorrect paths, stale conventions?
  3. Is anything unnecessary? — sections that add noise without value?
  4. Tone and style — too verbose? Too terse? Right level of detail?

3. Apply Adjustments

Make requested changes to the generated file(s). Common adjustments:

  • Add project-specific environment variables or secrets handling
  • Add team-specific review processes
  • Adjust emphasis on certain workflows over others
  • Add links to external resources (CI/CD dashboards, design tools, etc.)

4. Validate File Locations

Confirm files are in the correct locations:

Target Expected Location Exists?
Claude Code CLAUDE.md (project root) ✅/❌
GitHub Copilot .github/copilot-instructions.md ✅/❌
Windsurf .windsurf/rules/_ai-context.md ✅/❌
Cursor .cursor/rules/_ai-context.mdc ✅/❌

5. Commit

Commit the generated config file(s) with:

docs(dsp): generate AI IDE configuration for {target}

- Generated {filename} from SAO.md, ESM artifacts, and workflow inventory
- Includes: architecture, docs map, workflows, skills, artifact templates,
  AI/human collaboration patterns, coding conventions, BPE workflow reference
- Target IDE: {Claude Code | GitHub Copilot | Windsurf | Cursor}

Deliverables

  • Config file(s) reviewed by user
  • Adjustments applied per user feedback
  • File locations validated
  • Committed to repository
  • AI IDE configured — DSP is complete.

Next Step

If BSP (Bootstrap Project) is not yet complete: run BSP now. BSP creates the Makefile, installs dependencies, and stands up the welcome page — all required by PIN-01.

If BSP is already complete: proceed to BSP-08 for the Construction Handoff and mode selection.

Do not start BPE or PIN directly from DSP — the project must be bootstrapped first.

Details
Order:
#6
Phase:
Predecessor:
DSP-5 Generate AI IDE Configuration
Created:
Apr 12, 2026
Last Updated:
Aug 27, 2026
Workflow
Deploy Software Process

Check prerequisite artifacts (ESM, DTA), choose target AI IDE, and generate configuration (CLAUDE.md / copilot-instructions.md / Windsurf/Cursor rules) so AI …

View Workflow
Assigned Agent

No agent assigned

Required Skills

No skills linked

Rules

No rules linked.

Input Artifacts 3
Output Artifacts

No output artifacts