AI_template/DOCS.md

Project Documentation Index: Starter Template

Technical index for developers and AI agents. Use this as the entry point to all docs/ files.

---

Documentation Languages

• Technical docs: English (docs/ and subfolders).
• Repository summary: README.md (English). New documents should be added in English unless noted.

---

Documentation Structure (root: docs/)

1) General Project Docs

• docs/archetypes.md — product archetypes and optional modules; pick what applies.
• docs/project-overview.md — goals, target users, chosen archetype, key flows (pick relevant), non-functional requirements.
• docs/phases-plan.md — Phase 0–4 plan with tasks across product, frontend, backend, infra, data/LLM.
• docs/content-structure.md — high-level UI/content structure and page sections (archetype‑specific examples).
• docs/dev-setup.md — local/CI setup once code exists.

1c) Architecture Decision Records (/docs/adr)

• docs/adr/README.md — how ADRs work.
• docs/adr/0000-template.md — ADR template.

1b) LLM / AI System (/docs/llm)

• docs/llm/prompting.md — prompt structure, versioning, output schemas.
• docs/llm/evals.md — evaluation strategy, datasets, regression gates.
• docs/llm/safety.md — privacy, injection defenses, reasoning_trace policy.
• docs/llm/caching-costs.md — caching layers, budgets, monitoring.
• docs/llm/rag-embeddings.md — RAG/embeddings design and evaluation.

2) Frontend (/docs/frontend)

• docs/frontend/overview.md — frontend scope and key user journeys (depends on archetype/modules).
• docs/frontend/architecture.md — canonical, locked frontend decisions (after Phase 1).
• docs/frontend/FRONTEND_ARCHITECTURE_PLAN.md — working architecture notes; archive/delete after Phase 1.
• docs/frontend/ui-ux-guidelines.md — UX/UI guidance for data review and approval flows.
• docs/frontend/seo-performance.md — performance and SEO recommendations.

3) Backend (/docs/backend)

• docs/backend/overview.md — backend scope (integrations, AI capability, optional pipelines/approvals/billing).
• docs/backend/architecture.md — canonical, locked backend decisions (after Phase 1).
• docs/backend/api-design.md — API resources and conventions (entities, rules, approvals, reports, billing, events).
• docs/backend/security.md — authN/Z, secret handling, webhook verification, audit/event logging.
• docs/backend/payment-flow.md — payment integration (provider-agnostic template; single source of truth for payment flows and webhooks).

4) Examples (/docs/examples)

• docs/examples/RECOMMENDATIONS-example.md — filled-in example of RECOMMENDATIONS.md for a compliance classifier (Archetype C).

---

Root-Level Files

• README.md — project overview and quick start.
• RULES.md — core repository rules for AI agents.
• RECOMMENDATIONS.md — project-specific decisions and overrides (template).
• CONTRIBUTING.md — commit conventions, PR rules, how to add docs/agents/ADRs.
• SECURITY.md — vulnerability disclosure policy.
• package.json — project metadata and Node.js engine requirement.
• .env.example — environment variables template.
• .editorconfig — editor formatting standards (indentation, line endings).

Agent Profiles (/agents)

• agents/README.md — agent index, selection guide, and shared context7 guidelines.
• agents/frontend-architect.md — frontend specialist (React, Next.js, accessibility, performance).
• agents/backend-architect.md — backend specialist (system design, databases, APIs).
• agents/security-auditor.md — security review (OWASP, auth, vulnerability assessment).
• agents/test-engineer.md — testing specialist (strategy, automation, CI/CD).
• agents/code-reviewer.md — code quality and PR review.
• agents/prompt-engineer.md — LLM prompt design and optimization.

GitHub Templates (/.github)

• .github/ISSUE_TEMPLATE/bug_report.md — bug report template.
• .github/ISSUE_TEMPLATE/feature_request.md — feature request template.
• .github/ISSUE_TEMPLATE/config.yml — issue template configuration.
• .github/PULL_REQUEST_TEMPLATE.md — PR description template.

---

How to Use This Index

• New to the project: read project-overview.md and phases-plan.md first.
• Designing features: use frontend/backend architecture docs plus API/security/payment flow specs.
• Expanding docs: add new English *.md files under docs/ and update this index with links.
• Contributing: read CONTRIBUTING.md for commit conventions and PR rules.

Last Updated: Phase 0 (Planning)