From 94a632644149de7647bf4c72fb3d85ac31068ec1 Mon Sep 17 00:00:00 2001 From: ProfRandom92 Date: Fri, 22 May 2026 11:05:29 +0200 Subject: [PATCH 1/2] docs: add agent guidance entrypoint --- AGENTS.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index b3ff45e..d4b35d3 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,5 +1,21 @@ # 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. +- 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. From 0230406f01e8e11cabb652eb7f3d5a74766e7286 Mon Sep 17 00:00:00 2001 From: ProfRandom92 Date: Fri, 22 May 2026 11:16:03 +0200 Subject: [PATCH 2/2] docs: align agent skill docs and privacy rule --- AGENTS.md | 9 +++++---- .../{artifact-validation.md => artifact_validation.md} | 0 .../{docs-positioning.md => docs_positioning.md} | 0 .../{git-pr-workflow.md => git_pr_workflow.md} | 0 .../{mcp-context-layer.md => mcp_context_layer.md} | 0 5 files changed, 5 insertions(+), 4 deletions(-) rename docs/codex_skills/{artifact-validation.md => artifact_validation.md} (100%) rename docs/codex_skills/{docs-positioning.md => docs_positioning.md} (100%) rename docs/codex_skills/{git-pr-workflow.md => git_pr_workflow.md} (100%) rename docs/codex_skills/{mcp-context-layer.md => mcp_context_layer.md} (100%) diff --git a/AGENTS.md b/AGENTS.md index d4b35d3..2ce1de7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,16 +2,17 @@ ## 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. +- 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. 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