From 670552a18b4eabb238d2d1c0818f0d48f1ea4d68 Mon Sep 17 00:00:00 2001 From: JohnDoe6345789 Date: Thu, 25 Dec 2025 20:34:42 +0000 Subject: [PATCH] docs: todo,sdlc,kickstart (3 files) --- docs/todo/0-kickstart.md | 35 +++++++++++++++++++++++++++++++++++ docs/todo/21-SDLC-TODO.md | 18 +++++++++--------- docs/todo/README.md | 3 ++- 3 files changed, 46 insertions(+), 10 deletions(-) create mode 100644 docs/todo/0-kickstart.md diff --git a/docs/todo/0-kickstart.md b/docs/todo/0-kickstart.md new file mode 100644 index 000000000..1cd5fdca5 --- /dev/null +++ b/docs/todo/0-kickstart.md @@ -0,0 +1,35 @@ +# Kickstart (TODOs) + +Use this file to pick your next task from `docs/todo/` and get to a clean “green” baseline quickly. + +## Read First (If New Here) + +- Project overview: [`../START_HERE.md`](../START_HERE.md), [`../INDEX.md`](../INDEX.md) +- Agent workflow: [`../../.github/prompts/0-kickstart.md`](../../.github/prompts/0-kickstart.md) + +## Suggested Order (Highest ROI First) + +1. **Get the repo building**: [`15-BUILD-FIXES-TODO.md`](15-BUILD-FIXES-TODO.md) +2. **Fix frontend build/TS issues**: [`5-FRONTEND-TODO.md`](5-FRONTEND-TODO.md) +3. **Stabilize DB/Prisma workflows**: [`7-DATABASE-TODO.md`](7-DATABASE-TODO.md) +4. **Security fundamentals**: [`10-SECURITY-TODO.md`](10-SECURITY-TODO.md) +5. **Testing infrastructure**: [`8-TESTING-TODO.md`](8-TESTING-TODO.md), [`3-TODO.md`](3-TODO.md) +6. **Workflows/SDLC**: [`1-TODO.md`](1-TODO.md), [`21-SDLC-TODO.md`](21-SDLC-TODO.md) + +## Definition Of Done (For Most Tasks) + +- From `frontends/nextjs/`: `npm run lint`, `npm run typecheck`, and relevant tests pass. +- The relevant checkbox is marked `[x]` in the appropriate TODO file, with a commit hash or PR link. + +## Quick Commands + +Run app workflows from `frontends/nextjs/`: + +- `npm ci` +- `npm run lint` +- `npm run typecheck` +- `npm run test:unit` +- `npm run build` + +If you need Prisma from `frontends/nextjs/`, the schema is at `../../prisma/schema.prisma` (see the Prisma notes in [`../../.github/prompts/0-kickstart.md`](../../.github/prompts/0-kickstart.md)). + diff --git a/docs/todo/21-SDLC-TODO.md b/docs/todo/21-SDLC-TODO.md index 85527011c..9ce873703 100644 --- a/docs/todo/21-SDLC-TODO.md +++ b/docs/todo/21-SDLC-TODO.md @@ -151,16 +151,16 @@ ## Prompts & Copilot Integration ### `.github/prompts/` Review -- [ ] Audit [0-kickstart.md](../.github/prompts/0-kickstart.md) for current accuracy -- [ ] Update [1-plan-feature.prompt.md](../.github/prompts/1-plan-feature.prompt.md) -- [ ] Review [2-design-component.prompt.md](../.github/prompts/2-design-component.prompt.md) +- [ ] Audit [0-kickstart.md](../../.github/prompts/0-kickstart.md) for current accuracy +- [ ] Update [1-plan-feature.prompt.md](../../.github/prompts/1-plan-feature.prompt.md) +- [ ] Review [2-design-component.prompt.md](../../.github/prompts/2-design-component.prompt.md) - [ ] Update all `3-impl-*.prompt.md` implementation prompts -- [ ] Review [4-test-*.prompt.md](../.github/prompts/4-test-run.prompt.md) testing prompts -- [ ] Update [5-review-code.prompt.md](../.github/prompts/5-review-code.prompt.md) -- [ ] Review [6-deploy-*.prompt.md](../.github/prompts/6-deploy-ci-local.prompt.md) deployment prompts -- [ ] Update [7-maintain-*.prompt.md](../.github/prompts/7-maintain-debug.prompt.md) maintenance prompts -- [ ] Review [8-docs-feature.prompt.md](../.github/prompts/8-docs-feature.prompt.md) -- [ ] Update [EEK-STUCK.md](../.github/prompts/EEK-STUCK.md) troubleshooting guide +- [ ] Review [4-test-*.prompt.md](../../.github/prompts/4-test-run.prompt.md) testing prompts +- [ ] Update [5-review-code.prompt.md](../../.github/prompts/5-review-code.prompt.md) +- [ ] Review [6-deploy-*.prompt.md](../../.github/prompts/6-deploy-ci-local.prompt.md) deployment prompts +- [ ] Update [7-maintain-*.prompt.md](../../.github/prompts/7-maintain-debug.prompt.md) maintenance prompts +- [ ] Review [8-docs-feature.prompt.md](../../.github/prompts/8-docs-feature.prompt.md) +- [ ] Update [EEK-STUCK.md](../../.github/prompts/EEK-STUCK.md) troubleshooting guide ### Copilot Instructions - [ ] Review `.github/copilot-instructions.md` for accuracy diff --git a/docs/todo/README.md b/docs/todo/README.md index e31ad95e3..7ef45d677 100644 --- a/docs/todo/README.md +++ b/docs/todo/README.md @@ -6,6 +6,7 @@ This folder contains comprehensive TODO lists organized by area of the MetaBuild | File | Area | Priority | |------|------|----------| +| [0-kickstart.md](0-kickstart.md) | Start here (how to use these TODOs) | High | | [1-TODO.md](1-TODO.md) | Workflows & SDLC automation | High | | [2-TODO.md](2-TODO.md) | Architecture & refactoring | High | | [3-TODO.md](3-TODO.md) | Testing & quality metrics | High | @@ -37,7 +38,7 @@ This folder contains comprehensive TODO lists organized by area of the MetaBuild ## How to Use -1. **Starting a task**: Check the relevant TODO file for context +1. **Starting a task**: Start with [0-kickstart.md](0-kickstart.md), then check the relevant TODO file for context 2. **Completing a task**: Mark with `[x]` and add commit reference 3. **Adding tasks**: Add to the appropriate category file 4. **Large initiatives**: Create a new numbered TODO file