Documentation index. Files are organized by purpose, not by date.
| File | Purpose |
|---|---|
| PRODUCT.md | Product purpose, user segments, JTBD |
| VALIDATION_MASTER.md | Master validation evidence, hypotheses, and next tests before business model canvas |
| BUSINESS_MODEL_CANVAS.md | Business Model Canvas v0.1 with Ikigai, yearly subscription, and alumni model hypotheses |
| File | Purpose |
|---|---|
| DESIGN.md | Design system: colors, typography, spacing, tokens |
| system-prompt.md | Supabase Auth SSR implementation rules (AI guidance) |
| gemini.md | Supabase data access patterns & architecture standards |
| map-db.md | Learning Map database schema |
| map-plan.md | Learning Map feature plan & core concepts |
| classroom-system-plan.md | Classroom system implementation plan |
| classroom_teams_design.md | Classroom teams schema design |
| EXTERNAL_APP_INTEGRATION.md | Guide for building external apps that connect to PSeed |
| MODULAR_REFACTORING.md | North Star wizard modular refactoring |
| NORTH_STAR_ENHANCEMENTS.md | North Star wizard enhancements guide |
| File | Purpose |
|---|---|
| END_NODE_FEATURE.md | End Node completion tracking & congratulations modal |
| IMPACT_PAGE_README.md | Impact landing page design documentation |
| GROUP_INTEGRATION_GUIDE.md | Assignment Groups integration guide |
| MAP_EDIT_SECURITY.md | Map editing authorization & security layers |
| DIRECTION_FINDER_SETUP.md | Direction Finder background jobs (deprecated) |
| walkthrough_floating_north_star.md | Floating North Star UI implementation |
| PERFORMANCE.md | Performance optimizations: bundle, images, caching |
| File | Purpose |
|---|---|
| hackathon-context.md | Hackathon codebase overview & architecture |
| TNDH-AI-Context.md | The Next Decade Hackathon 2026 — comprehensive context |
| hackathon-support-email-thai.md | Thai support email template for participants |
| EPIC_SPRINT_README.md | Epic Sprint report documentation |
| File | Purpose |
|---|---|
| DEPLOYMENT_SETUP.md | Vercel deployment optimization & resource limits |
| B2_CORS_SETUP.md | Backblaze B2 CORS configuration |
| DISCORD_BOT_SETUP.md | Discord bot setup for mentor notifications |
| CLEANUP_SUMMARY.md | Post-cleanup migration guide (test mode & cron removal) |
| FIXES.md | Direction Finder schema validation fixes |
| DREAM_STATE_ANALYSIS.md | 12-month roadmap gap analysis |
| debug.md | Browser console error logs (raw debugging output) |
| File | Purpose |
|---|---|
| JOURNEY_MAP_TESTING.md | Journey Map feature testing guide |
| TEST_END_NODE.md | End Node feature testing steps |
| AI_QUIZ_GENERATION_PROMPT.md | Quiz question generation prompt spec |
| TESTING_CONCURRENT_JOBS.md | Concurrent job testing (deprecated) |
| TEST_STATUS.md | Test setup status (deprecated) |
| QUICK_TEST_GUIDE.md | Quick 10-user test (deprecated) |
| File | Purpose |
|---|---|
| all_migrations.md | All SQL migrations combined (auto-generated) |
| note.md | Random notes (angpao IDs) |
| plan.md | Old performance optimization plan |
These files stay in the repository root because they are read by AI coding tools (Codex, Claude Code) that look for them at the project root:
AGENTS.md— Codex AI guidanceCLAUDE.md— Claude Code AI guidanceREADME.md— Project overview & getting started