# LinaAI Knowledge Map

This map defines the project memory LinaAI should consult before working. It is
not a replacement for reading source files. It is the first-read order for
context.

## First Read For Agrarian

1. `Docs/AI/LinaAIOperatingManual.md`
2. `Docs/AI/LocalAgentGuardrails.md`
3. `Docs/AI/LinaAISecretsPolicy.md`
4. `Docs/Ops/HANDOFF.md`
5. `AGRARIAN_DEVELOPMENT_ROADMAP.md`
6. `Docs/CoreDesignDocument.md`
7. `Docs/TechnicalDesignDocument.md`
8. `Docs/SixMonthMvpDefinition.md`
9. `Docs/MvpSurvivalReadinessCriteria.md`
10. `Docs/Investor/InvestorDemoAcceptanceGate.md`

## System-Specific Internal Docs

Use these before touching the named area.

- Visuals and assets:
  `Docs/Art/AgrarianAssetPipeline.md`,
  `Docs/Art/AssetLicenses.md`,
  `Docs/Art/GroundZeroAssetAcquisitionQueue.md`,
  `Docs/Rendering/InvestorRenderingPresets.md`.
- Terrain and world generation:
  `Docs/Terrain/GroundZeroTile.md`,
  `Docs/Terrain/GroundZeroNaturalEnvironmentPass.md`,
  `Docs/Terrain/UnrealLandscapeImportPlan.md`,
  `Docs/World/BiomeAndNaturalResourceGenerationPlan.md`.
- Persistence:
  `Docs/PersistenceDesignDocument.md`,
  `Docs/Ops/PersistenceSaveRecoveryPlan.md`.
- Multiplayer:
  `Docs/MultiplayerNetworkingDesign.md`,
  `Docs/Ops/DedicatedServerBuildRunbook.md`,
  `Docs/Ops/MultiplayerLatencyTestPlan.md`.
- Economy and AGR:
  `Docs/EconomyAndAgrDesignDocument.md`.
- Infrastructure and repo policy:
  `Docs/RepositoryStoragePolicy.md`,
  `Docs/BranchingConventions.md`,
  `Docs/CommitMessageConventions.md`,
  `Docs/BackupExpectations.md`.

## Official Vendor Documentation

Refresh local cached copies with `Scripts/linaai_refresh_knowledge.sh`. The
tracked repo stores URLs and notes; downloaded vendor pages stay under ignored
`Saved/LinaAIKnowledge/`.

- Unraid docs: `https://docs.unraid.net/`
- Unreal Engine 5.7 docs: `https://dev.epicgames.com/documentation/en-us/unreal-engine`
- Laravel 12 docs: `https://laravel.com/docs/12.x`
- MySQL 8.4 Reference Manual: `https://dev.mysql.com/doc/refman/8.4/en/`
- Gitea docs: `https://docs.gitea.com/`
- Ollama docs: `https://docs.ollama.com/`
- Open WebUI docs: `https://docs.openwebui.com/`
- Aider docs: `https://aider.chat/docs/`

## Infrastructure Map

- Gitea: `http://192.168.5.21:3000`
- Agrarian game repo:
  `http://192.168.5.21:3000/nathan/agrarian-game.git`
- Ollama: `http://192.168.5.23:11434`
- Open WebUI: `http://192.168.5.26:8085`
- LinaAI VM: `192.168.5.27`
- Unreal build VM: `192.168.5.20`
- Unraid host: `192.168.5.8`

Credentials are intentionally not listed here. See
`Docs/AI/LinaAISecretsPolicy.md`.

## Knowledge Refresh Rule

Run a knowledge refresh before large planning, repo migrations, infrastructure
changes, or when vendor behavior matters:

```bash
Scripts/linaai_refresh_knowledge.sh
Scripts/linaai_bootstrap_context.sh
```

If downloaded docs are unavailable, LinaAI should continue with tracked project
docs and state the gap in its evidence.