# DoIt Comprehensive Tutorials

**Completed**: 2026-01-13
**Branch**: 019-doit-tutorials
**Priority**: P1

## Overview

Two comprehensive, step-by-step tutorials that demonstrate the complete DoIt workflow from start to finish. These tutorials serve as the primary learning resource for new users, showing real examples of every command, expected interactions, and decision points throughout the spec-driven development process.

## Features

### Greenfield Tutorial

Start from scratch with a new project, demonstrating full project initialization and the complete feature development cycle:

- DoIt installation and verification steps
- `doit init` with full interactive prompts
- All slash commands: `/doit.constitution`, `/doit.scaffoldit`, `/doit.specit`, `/doit.planit`, `/doit.taskit`, `/doit.implementit`, `/doit.reviewit`, `/doit.testit`, `/doit.checkin`
- Realistic task management app example
- GitHub issue closure and PR creation workflow

### Existing Project Tutorial

Add DoIt to an existing codebase without disrupting existing work:

- Prerequisites for adding DoIt to existing projects
- Constitution adaptation for existing codebases
- Referencing existing code and patterns in specifications
- Full workflow completion for adding a new feature

### Tutorial Quality

- Annotated code blocks with exact command inputs
- Expected output for each command
- Callout boxes for tips, warnings, and notes
- Visual workflow diagrams
- "What You'll Build" sections with prerequisites checklists

## Requirements Implemented

| ID | Description | Status |
|----|-------------|--------|
| FR-001 | Installation and verification steps | Done |
| FR-002 | `doit init` with full interactive prompts | Done |
| FR-003 | `/doit.constitution` with example principles | Done |
| FR-004 | `/doit.scaffoldit` initial structure | Done |
| FR-005 | `/doit.specit` with ambiguity resolution | Done |
| FR-006 | `/doit.planit` approval workflow | Done |
| FR-007 | `/doit.taskit` task structure | Done |
| FR-008 | `/doit.implementit` with examples | Done |
| FR-009 | `/doit.reviewit` with feedback handling | Done |
| FR-010 | `/doit.checkin` with GitHub integration | Done |
| FR-013 | Existing project prerequisites | Done |
| FR-025 | Command workflow visualizations | Done |

## Testing

- Tutorial completion verification
- All command examples work as documented
- Cross-platform compatibility (Windows/Mac/Linux)
- Support for `--skip-issues` flag for non-GitHub users

## Related Documentation

- [Tutorial Index](../tutorials/index.md)
- [Greenfield Tutorial](../tutorials/01-greenfield-tutorial.md)
- [Existing Project Tutorial](../tutorials/02-existing-project-tutorial.md)

---

Generated by `/doit.documentit` on 2026-01-22
