diff --git a/AGENTS.md b/AGENTS.md index b3ff45e..2ce1de7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,5 +1,22 @@ # CompText V7 Agent Instructions +## Repo-local skill docs +- Before starting work, read the relevant docs under `docs/codex_skills/`. +- Use `docs/codex_skills/mcp_context_layer.md` for MCP context layer, CLI, prompt rendering, validation, and adapter work. +- Use `docs/codex_skills/artifact_validation.md` for deterministic artifacts and regeneration checks. +- Use `docs/codex_skills/git_pr_workflow.md` for branch sync, commits, pushes, and PR preparation. +- Use `docs/codex_skills/docs_positioning.md` for README/docs positioning and scope boundaries. + +## Default safety rules +- Repository state is the source of truth. +- Inspect before editing. +- Make the smallest safe patch. +- Keep behavior deterministic and fixture-bound. +- Maintain local sanitization and privacy boundaries (GDPR/DSGVO Art. 25) at all times. +- Do not introduce semantic scoring, embeddings, vector DBs, external APIs, autonomous orchestration, or runtime tool execution unless explicitly scoped. +- Prefer focused validation over broad checks unless the task requires broader validation. +- Do not commit, push, create PRs, or merge unless explicitly requested. + ## Project focus - CompText V7 is the deterministic replay-integrity layer for compressed operational agent traces. - Current focus: core foundation, deterministic replay artifacts, CI artifacts, docs, and conservative positioning. diff --git a/docs/codex_skills/artifact-validation.md b/docs/codex_skills/artifact_validation.md similarity index 100% rename from docs/codex_skills/artifact-validation.md rename to docs/codex_skills/artifact_validation.md diff --git a/docs/codex_skills/docs-positioning.md b/docs/codex_skills/docs_positioning.md similarity index 100% rename from docs/codex_skills/docs-positioning.md rename to docs/codex_skills/docs_positioning.md diff --git a/docs/codex_skills/git-pr-workflow.md b/docs/codex_skills/git_pr_workflow.md similarity index 100% rename from docs/codex_skills/git-pr-workflow.md rename to docs/codex_skills/git_pr_workflow.md diff --git a/docs/codex_skills/mcp-context-layer.md b/docs/codex_skills/mcp_context_layer.md similarity index 100% rename from docs/codex_skills/mcp-context-layer.md rename to docs/codex_skills/mcp_context_layer.md