Note

    README

    How to navigate the docs for Portfolio Command, the private AI-assisted portfolio command center. stat...

    Document Metadata

    • title: Documentation Index
    • description: How to navigate the docs for Portfolio Command, the private AI-assisted portfolio command center.
    • status: stable
    • lastUpdated: "2026-03-20 14:54 ET (America/New_York)"
    • owner: Documentation

    Documentation Index > How to navigate the docs for Portfolio Command, a private operator dashboard for portfolio focus an

    Documentation Index

    How to navigate the docs for Portfolio Command, a private operator dashboard for portfolio focus and strategic alignment.

    Quick Reference

    DocPurposeRead when…
    STRATEGY.mdWhat the project is trying to solve and the “strategist” logic behind alignment and focusYou want the intent, target user, outcomes, and decision rules (the “why”)
    SOLUTION.mdHow the project solves the problem end-to-end (pipelines, snapshot model, scoring, UI surfaces)You want the high-level implementation story (the “how”)
    FEATURES.mdWhat the app does, why each feature exists, current statusYou want to understand what's built and why it matters
    APP_STRUCTURE.mdCodebase layout, design rationale, key file relationshipsYou're about to make changes and need to know where things live
    ARCHITECTURE.mdDeep technical spec — schemas, RLS policies, data flows, design systemYou need exact table definitions, security rules, or the snapshot contract
    AI_COMPONENTS.mdAI pipeline details — prompts, scoring formulas, provider routingYou're debugging AI output, tuning prompts, or understanding focus scores
    testing.mdHow to run and write tests (frontend, standalone API, E2E, live smoke, live backend integration)You want to run tests locally or add coverage
    contracts.mdBackend API request/response contracts for the standalone API surfaceYou're integrating with backend APIs
    standalone-api.mdNode/Fastify backend implementation and runtime contractsYou're working on the standalone backend and deployment behavior
    SELF_HOSTING.mdStep-by-step guide to run the project on your own infrastructureYou're deploying outside Lovable or setting up a local dev environment
    RELEASE_CHECKLIST.mdMerge/deploy verification policy for the Live Smoke workflowYou need to decide whether release verification is required for a change
    FIRST_PROMPT.mdThe original prompt that started this projectYou want to understand the initial vision and constraints
    LEAN_CANVAS.mdOne-page business model canvasYou want to understand positioning, customers, and revenue model
    PROMPT_HISTORY.mdChronological log of every build message and what it producedYou want to trace when and why a specific feature was added

    Reading Order

    New to the project? Start here:

    1. FEATURES.md — understand what this thing does and why
    2. APP_STRUCTURE.md — see how the code is organized
    3. ARCHITECTURE.md — go deep on schemas, security, and data flow

    Debugging AI behavior? → Go straight to AI_COMPONENTS.md

    Trying to figure out when something was built or changed? → PROMPT_HISTORY.md has the full timeline

    Want the original design intent? → FIRST_PROMPT.md is the seed that produced everything else

    Provenance