110 lines
2.6 KiB
Markdown
110 lines
2.6 KiB
Markdown
# ATM Expert Agent Plan
|
|
|
|
## Goal
|
|
|
|
Replace `.opencode/agent/computercraft.md` with `atm10-expert`.
|
|
|
|
The agent targets ATM10 / All The Mods 10, Minecraft `1.21.1`, NeoForge, pack version `7.0` (`0.7.0` accepted as user alias).
|
|
|
|
## Known Facts
|
|
|
|
CurseForge project id: `925200`.
|
|
|
|
ATM10 `7.0` file id: `8091114`.
|
|
|
|
Server pack file id: `8094893`.
|
|
|
|
NeoForge version: `21.1.228`.
|
|
|
|
GitHub source: <https://github.com/AllTheMods/ATM-10>
|
|
|
|
## Files To Create
|
|
|
|
Create `.opencode/agent/atm10-expert.md`.
|
|
|
|
Create `.opencode/agent-context/atm10-expert/INDEX.md`.
|
|
|
|
Create `.opencode/agent-context/atm10-expert/glossaries/`.
|
|
|
|
Create `.opencode/agent-context/atm10-expert/scripts/`.
|
|
|
|
Create `.opencode/agent-context/atm10-expert/modpacks/atm10-7.0.md`.
|
|
|
|
## Files To Move
|
|
|
|
Move in-game glossaries only:
|
|
|
|
`docs/cc_glossary.md` to agent context.
|
|
|
|
`docs/create_cc_tweaked_glossary.md` to agent context.
|
|
|
|
`docs/advanced_peripherals_glossary.md` to agent context.
|
|
|
|
Keep `docs/craftos_pc_glossary.md` in `docs/`.
|
|
|
|
Update `docs/README.md` links.
|
|
|
|
## Agent Behavior
|
|
|
|
Delete old `computercraft` agent.
|
|
|
|
New agent answers players concisely for in-game terminals.
|
|
|
|
Use local glossaries first, then websearch/webfetch.
|
|
|
|
Default to non-technical answers.
|
|
|
|
Adapt language to the user, usually French.
|
|
|
|
If a new useful mod documentation source is found, update or create a glossary and update `INDEX.md`.
|
|
|
|
Keep replies short unless the user asks for detail.
|
|
|
|
Use MCP bridge carefully: probe first, execute only bounded/read-only Lua unless explicitly asked.
|
|
|
|
## Permissions
|
|
|
|
Allow local read/search and web lookup.
|
|
|
|
Keep MCP bridge `probe-computers` and `exec-lua`.
|
|
|
|
Make edit/bash approval-gated or tightly limited, because this agent is player-facing.
|
|
|
|
Allow `just check` for markdown validation.
|
|
|
|
## ATM10 Mod List Script
|
|
|
|
Add `.opencode/agent-context/atm10-expert/scripts/fetch-atm10-7.0-mods.sh`.
|
|
|
|
Script should download CurseForge file `8091114`.
|
|
|
|
Extract `manifest.json`.
|
|
|
|
Write raw project/file ids and best available names to `modpacks/atm10-7.0.md`.
|
|
|
|
If `CURSEFORGE_API_KEY` exists, resolve project names through the CurseForge API.
|
|
|
|
Without API key, preserve ids and URLs for later glossary enrichment.
|
|
|
|
## TrapOS AI Context
|
|
|
|
Update `programs/ai.lua` / `apis/libai.lua` so each prompt includes hidden caller context:
|
|
|
|
computer id.
|
|
|
|
computer label, if any.
|
|
|
|
This helps `atm10-expert` know which in-game computer is calling.
|
|
|
|
Add tests in `tests/ai.lua`.
|
|
|
|
Bump `packages/trapos-ai/ccpm.json` and `packages/index.json`.
|
|
|
|
## Verification
|
|
|
|
Run `just check`.
|
|
|
|
Fix Lua lint and markdown link issues.
|
|
|
|
Restart opencode after agent/config changes.
|