YAS.SH Enterprise Platform V3 — Documentation Index
Single entry point: 00_MASTER.md — read it first, then follow numeric order.
| Doc | Title | Purpose | Lines |
|---|---|---|---|
00_MASTER.md |
Master Specification | Vision, laws, repo map, reading order | ~180 |
01_ARCHITECTURE.md |
Architecture | Monorepo, modules, C4, layering, auto-discovery | ~180 |
02_TECH_STACK.md |
Tech Stack | Locked stack, exact pins, freshness governance | ~150 |
03_DATABASE.md |
Database | MariaDB 11 + Prisma, schema, indexes, backup, PG path | ~190 |
04_API_PLATFORM.md |
API Platform | API-first, OpenAPI 3.1, 5 full groups, SDKs | ~210 |
05_UI_UX.md |
UI / UX | Linear/Vercel/Stripe/Raycast + tools.yas.sh tokens | ~150 |
06_MODULE_SYSTEM.md |
Module System | modules/*/module.json plug-in, adding a tool = one folder |
~160 |
07_BLOG_SYSTEM.md |
Blog System | MDX Content Collections, frontmatter, 5 production posts | ~140 |
08_SECURITY.md |
Security | OWASP, headers, SSRF, secrets, OL9 hardening | ~160 |
09_TESTING.md |
Testing | Gates per phase, smoke, coverage, a11y, contract | ~140 |
10_DEPLOYMENT.md |
Deployment | macOS (no brew) → Docker → Oracle Linux 9 | ~150 |
11_ROADMAP.md |
Roadmap | Phases 0-6: 5 → 10 → 50 FREE → 150 total | ~160 |
12_AI_WORKFLOW.md |
AI Workflow | Session ritual, phase loop, proof, delivery | ~120 |
13_PACKAGE_SELECTION_POLICY.md |
Package Policy | Scoring 90+ to install, gates | ~110 |
14_PRODUCT_SPECIFICATION.md |
Product Specification | 50 FREE + 100 PAID = 150 features, 5 fully specced | ~450 |
15_OPERATIONS_ORACLE_LINUX.md |
Operations (OL9) | Proxy, TLS, monitoring, backups, recovery | ~200 |
16_USER_GUIDE.md |
User Guide | Getting started, feature tour, troubleshooting | ~250 |
17_CONTENT_EXPANSION.md |
Content Expansion | Add tools & blog posts (EN/AR) modularly — registries, scaffolders, wave gates | ~300 |
PROJECT_MEMORY_TEMPLATE.md |
Memory Template | Living doc the AI updates every session | ~140 |
CHECKLIST.md |
Release Checklist | Tickable gates for Phase 1 release | ~180 |
Total: 17 docs, modular, each <250 lines except product spec (intentionally exhaustive).
Start building: 00_MASTER.md → 12_AI_WORKFLOW.md session ritual → 11_ROADMAP.md Phase 1 → 06_MODULE_SYSTEM.md to add first module.