This repository has been archived on 2026-05-24. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
AgrarianGameArchive/Docs/AI/LinaAIKnowledgeMap.md
T
2026-05-24 07:54:37 +00:00

91 lines
2.9 KiB
Markdown

# 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.