docs(repo): flow-pack closeout — PRPs, onboarding docs, flow-prime fix (#368)

[w7-mgfcode]

Summary

Closes out the flow-pack branch: tracks the E2–E4 flow-pack PRPs, adds the generated
onboarding / role-deep-dive / architecture docs, fixes the flow-prime milestone query,
and corrects the stale vertical-slice count (11 → 19) in the base docs. Docs + repo-hygiene
only — no app/ code, no schema, no runtime behavior change.

Type of Change

• docs — documentation only
• chore / ci — repo hygiene (.gitignore: ignore .understand-anything/ generator state)

One commit carries fix(repo): ... (flow-prime milestone query); it is doc/command-only
and will register as a PATCH on the next dev → main release per release-please config.

Commits (4)

7a34b3b docs(repo): correct slice count 11 to 19 in base docs (#376)
4984713 docs(repo): add onboarding guide, role deep-dives, and architecture diagrams (#368)
1f7fd82 fix(repo): correct flow-prime milestone query (#371)
7799d53 docs(repo): track flow-pack E2-E4 PRPs (#368)

Files (14 changed · +3680 / −4)

• flow-pack PRPs: PRPs/flow-brainstorm.md (E2), PRPs/PRP-flow-pack-E3-flow-umbrella.md, PRPs/PRP-flow-pack-E4-flow-epics.md
• flow-prime fix: docs/flow-pack/commands/flow-prime.md (gh milestone list → gh api .../milestones)
• generated docs deliverable: docs/ONBOARDING.md, docs/arch-dia.md, docs/arch-techstack.md, docs/_repoKB-deepdive/{ai-engineer,product-manager,software-architect,software-developer}.md
• slice-count fix: docs/_base/ARCHITECTURE.md, docs/_base/REPO_MAP_INDEX.md (11 → 19)
• repo hygiene: .gitignore (+.understand-anything/)

Checklist

Code Quality

• N/A — no Python touched (docs + .gitignore only); ruff/mypy/pyright not applicable

Testing

• N/A — no code/behavior change; nothing to test

Database

• No database changes required

Documentation

• Updated relevant documentation (this PR is the documentation change)
• Tracked↔local flow-command sync verified (all 4 docs/flow-pack/commands/* match .claude/commands/flow/*)
• New-doc internal links + cited code paths resolve (repo-visibility audit: CLEAN)
• Rule-drift audit run: no flow-pack rule contradicts docs/flow-pack-methodology.md

Security

• No secrets, credentials, or API keys added

Testing Instructions

Docs-only. Optional sanity:

• rg -n "11 backend vertical slices|Eleven vertical slices" docs/_base → no matches
• git diff --stat dev...HEAD → 14 files, docs/.gitignore only

Related Issues

Relates to #368, #371, #376.

---

Excluded by design and NOT in this PR: uv.lock (untouched), docker-compose.lan.yml
(untracked, "do not commit"), .understand-anything/ (gitignored generator state).

[sourcery-ai]

Sorry @w7-mgfcode, your pull request is larger than the review limit of 150000 diff characters

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 3b39d234-7c9c-417b-a3f1-d9024f9cc8a7

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/flow-pack-closeout

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}