Document the Specification-Driven Development (SDD) workflow in the Web Dev Path Wiki

[mariana-caldas]

What do we need to build or fix?

Document the Specification-Driven Development (SDD) workflow in the Web Dev Path Wiki.

The Services Page initiative is the first project using specification documents as a source of truth. We need documentation explaining how contributors can use these documents during implementation, including when working with AI-assisted development tools such as Claude, GitHub Copilot, Cursor, and ChatGPT.

This documentation should help new contributors understand:

• What each specification document is for.
• When they should read it.
• How specifications relate to GitHub Issues.
• How specifications can be used to improve AI-generated code.

Technical details

Create a new Wiki page describing:

Specification Documents

• specification.md
• decisions.md
• tasks.md
• references.md

Recommended Workflow

Specification
→ GitHub Issue
→ Implementation
→ Pull Request

AI-Assisted Development Workflow

Provide practical examples showing how contributors can:

• Read specification files
• Provide them to Claude, Cursor, Copilot, or ChatGPT
• Ask AI tools to implement features using project context rather than isolated instructions

Services Page Example

Use the Services Page initiative as the first example implementation.

Approach suggestions

The documentation should remain lightweight and practical.

Focus on:

• Real contributor workflows
• Concrete examples
• AI-assisted development usage
• Reducing implementation ambiguity

Avoid:

• Excessive process
• Theoretical discussions
• Full GitHub Spec Kit implementation details

Deadline

Please keep in mind that once you assign this task to yourself, you'll need to complete it within 10 days.

Acceptance criteria

• New Wiki page created.
• Purpose of each specification document explained.
• Relationship between specifications and GitHub Issues explained.
• Relationship between specifications and Pull Requests explained.
• At least three examples using Claude, Cursor, Copilot, or ChatGPT included.
• Services Page used as the primary example.
• Documentation reviewed by the team.