# Task 001 — Documentation System

## Objective

Validate, cross-link, and harden the documentation system so every future task has a clear, consistent doc update checklist and navigation path.

## Scope

- Review all `/docs` files for consistency (naming, cross-links, terminology)
- Add a `docs/README.md` index with descriptions and reading order
- Ensure task files reference correct doc paths
- Add `.env.example` at repo root (values empty) aligned with `10-environment-variables.md`
- Fix any gaps found in API/schema/UI alignment from Phase 1 review

**Out of scope:** Application code, Next.js scaffold (Task 002).

## Requirements

1. `docs/README.md` lists all docs with one-line descriptions and suggested reading order for new developers.
2. Broken or missing internal links between docs are fixed.
3. `.env.example` includes every variable from `10-environment-variables.md`.
4. Terminology aligned: “Growth Platform”, entity names (company, person, lead, opportunity).
5. `tasks/README.md` lists tasks by phase with status column (all `pending` except 000 `complete`).

## Files to create or modify

| Path | Action |
|------|--------|
| `docs/README.md` | Create index |
| `tasks/README.md` | Create task index by phase |
| `.env.example` | Create from env doc |
| `docs/*.md` | Fix links and consistency as needed |
| `docs/16-changelog.md` | Task 001 entry |

## Acceptance criteria

- [x] `docs/README.md` and `tasks/README.md` exist
- [x] `.env.example` matches env documentation
- [x] No broken relative links in docs (spot-check all files)
- [x] Changelog updated for Task 001
- [x] Owner confirms docs are ready before Task 002

## Documentation updates required

- [x] `docs/16-changelog.md`
- [x] `docs/README.md` (new)
- [x] `tasks/README.md` (new)
- [x] `docs/10-environment-variables.md`, `docs/15-cursor-rules.md`, `docs/14-roadmap.md`

**Status:** Complete