Add project AGENTS.md to replace stale LLM_SYSTEM_PROMPT.md #3

New issue

Closed

opened 2026-09-10 03:25:50 +00:00 by agent-pi · 1 comment

agent-pi commented

2026-09-10 03:25:50 +00:00

Collaborator

Problem

The repo's only agent-instructions file, LLM_SYSTEM_PROMPT.md, is stale:

It points at Codeberg, but the project lives on forge.marvin8.zone.
It pre-dates both the abandonment and the LLM-revival direction (issue #1).
It doesn't match current tooling (uv-ship/calver releases, prek, nox-uv, complexipy, docs dependency group).

Agents (pi included) read AGENTS.md natively. The project should have one canonical, current instructions file so agent behaviour is consistent across sessions and machines.

## Problem The repo's only agent-instructions file, `LLM_SYSTEM_PROMPT.md`, is stale: - It points at Codeberg, but the project lives on forge.marvin8.zone. - It pre-dates both the abandonment and the LLM-revival direction (issue #1). - It doesn't match current tooling (uv-ship/calver releases, prek, nox-uv, complexipy, docs dependency group). Agents (pi included) read `AGENTS.md` natively. The project should have one canonical, current instructions file so agent behaviour is consistent across sessions and machines.

agent-pi commented

2026-09-10 03:26:11 +00:00

Author

Collaborator

Plan of attack

Add AGENTS.md scoped to yunjin-specific guidance only — the global ~/.pi/agent/AGENTS.md on the agent box already covers import style, docstrings, dependency pinning, TDD, the forge workflow, and the main-off-limits invariant; none of that is duplicated here.
Contents: repo location and no-CI note, tooling commands (uv/pytest/ruff/ty; prek and nox human-only), architecture map (services → raw-SQL db → Flask web; alembic), project conventions (httpx not requests, minimal JS, deuteranopia-safe palettes, async I/O), hands-off files (CHANGELOG.md, ruff.toml, RELEASE_NOTES_*.md), uv-ship release flow, and the LLM direction pointer (issue #1) with env-var config naming (YUNJIN_LLM_API_KEY / YUNJIN_LLM_BASE_URL / YUNJIN_LLM_MODEL, keys from env only).
Delete LLM_SYSTEM_PROMPT.md in the same PR.
README and Roadmap "abandoned" notices stay as-is until the LLM service lands (decided with Marvin8).

Branch: docs/issue-3-add-agents-md

Commits:

:memo: Replace LLM_SYSTEM_PROMPT.md with project AGENTS.md

PR: opened via the Forgejo API targeting main, body with Closes #3.

## Plan of attack 1. Add `AGENTS.md` scoped to yunjin-specific guidance only — the global `~/.pi/agent/AGENTS.md` on the agent box already covers import style, docstrings, dependency pinning, TDD, the forge workflow, and the main-off-limits invariant; none of that is duplicated here. 2. Contents: repo location and no-CI note, tooling commands (uv/pytest/ruff/ty; prek and nox human-only), architecture map (services → raw-SQL db → Flask web; alembic), project conventions (httpx not requests, minimal JS, deuteranopia-safe palettes, async I/O), hands-off files (`CHANGELOG.md`, `ruff.toml`, `RELEASE_NOTES_*.md`), uv-ship release flow, and the LLM direction pointer (issue #1) with env-var config naming (`YUNJIN_LLM_API_KEY` / `YUNJIN_LLM_BASE_URL` / `YUNJIN_LLM_MODEL`, keys from env only). 3. Delete `LLM_SYSTEM_PROMPT.md` in the same PR. 4. README and Roadmap "abandoned" notices stay as-is until the LLM service lands (decided with Marvin8). Branch: `docs/issue-3-add-agents-md` Commits: - `:memo: Replace LLM_SYSTEM_PROMPT.md with project AGENTS.md` PR: opened via the Forgejo API targeting `main`, body with `Closes #3`.

agent-pi referenced this issue from a commit

2026-09-10 03:27:22 +00:00

:memo: Replace LLM_SYSTEM_PROMPT.md with project AGENTS.md

agent-pi referenced this issue from a pull request that will close it,

2026-09-10 03:27:37 +00:00

Replace stale LLM_SYSTEM_PROMPT.md with project AGENTS.md #4

agent-pi referenced this issue from a commit

2026-09-10 04:21:55 +00:00

:memo: Address review: httpx2 convention, just releases, global release-notes steps

agent-pi referenced this issue from a commit

2026-09-10 04:27:47 +00:00

:memo: CHANGELOG.md is generated by the justfile release recipe