# Project Brief

## 1. Product Context

This repository is the MVP foundation for The Mindscape of Bro Tsong.

The current phase is the cognitive model management subsystem MVP, also called `model_library_mvp`.

It supports a future problem-answering / cognitive-processing system that will use selected cognitive models to analyze user inputs.

## 2. First User

The first user is the project owner.

This is an OPC-oriented product workflow.

The system should reduce the burden of managing, testing, and reusing cognitive models as a one-person company.

## 3. Core Need

The project solves a model asset management problem:

- Existing cognitive models are scattered across articles and previous model indexes.
- Model cards need stronger source traceability.
- Some early models require regression testing and stabilization.
- The future question-answering system needs callable model specifications.
- Model and card indexes need script-backed synchronization so the library does not drift into scattered files.

## 4. MVP Focus

The MVP focuses on two models:

- QPI
- Intellectual Archaeology

These two models are used to validate the model extraction protocol.

The current index maintenance rule is documented in `docs/INDEX_MAINTENANCE_PROTOCOL.md`: every asset change synchronizes `models/model_index.json` and `cards/card_index.md`, while handoff and release points require a full rebuild or check.

## 5. Long-Term Direction

Future versions may support:

- 8-10 core models
- 20 extended models
- Model selector
- Multi-lens analysis workflow
- Conflict summarization
- Integrated question-answering system
- Source article integration
- Model regression dashboard

These are not part of v0.1 unless explicitly requested.

## 6. Project Ecosystem

This repository is separate from but related to:

- `knowledge-vault`: upstream source archive and discussion records.
- `ccpe-system`: expert-agent and runtime specification workspace.
- `skills-vault`: canonical source for reusable automation skills.
- `writing-workbench`: deep writing production workspace.
- `video-workbench`: dimensional output workspace.

This project may reference artifacts from those repositories, but its own boundary is the model asset foundation for The Mindscape of Bro Tsong.