Agenta-AI · mmabrouk · Jul 31, 2026 · Jul 31, 2026
diff --git a/agents/docs/code-review/README.md → .agents/docs/code-review/README.md b/agents/docs/code-review/README.md → .agents/docs/code-review/README.md
diff --git a/agents/docs/code-review/criteria.md → .agents/docs/code-review/criteria.md b/agents/docs/code-review/criteria.md → .agents/docs/code-review/criteria.md
diff --git a/agents/docs/code-review/deliverables.md → .agents/docs/code-review/deliverables.md b/agents/docs/code-review/deliverables.md → .agents/docs/code-review/deliverables.md
diff --git a/agents/docs/code-review/docs.specs.md → .agents/docs/code-review/docs.specs.md b/agents/docs/code-review/docs.specs.md → .agents/docs/code-review/docs.specs.md
diff --git a/agents/docs/code-review/guidelines.md → .agents/docs/code-review/guidelines.md b/agents/docs/code-review/guidelines.md → .agents/docs/code-review/guidelines.md
diff --git a/agents/docs/code-review/instructions.md → .agents/docs/code-review/instructions.md b/agents/docs/code-review/instructions.md → .agents/docs/code-review/instructions.md
diff --git a/agents/docs/code-review/rubrics/api.md → .agents/docs/code-review/rubrics/api.md b/agents/docs/code-review/rubrics/api.md → .agents/docs/code-review/rubrics/api.md
diff --git a/.../docs/code-review/rubrics/architecture.md → .../docs/code-review/rubrics/architecture.md b/.../docs/code-review/rubrics/architecture.md → .../docs/code-review/rubrics/architecture.md
diff --git a/agents/docs/code-review/rubrics/databases.md → ...nts/docs/code-review/rubrics/databases.md b/agents/docs/code-review/rubrics/databases.md → ...nts/docs/code-review/rubrics/databases.md
diff --git a/agents/docs/code-review/rubrics/general.md → .agents/docs/code-review/rubrics/general.md b/agents/docs/code-review/rubrics/general.md → .agents/docs/code-review/rubrics/general.md
diff --git a/...docs/code-review/rubrics/observability.md → ...docs/code-review/rubrics/observability.md b/...docs/code-review/rubrics/observability.md → ...docs/code-review/rubrics/observability.md
diff --git a/...s/docs/code-review/rubrics/performance.md → ...s/docs/code-review/rubrics/performance.md b/...s/docs/code-review/rubrics/performance.md → ...s/docs/code-review/rubrics/performance.md
diff --git a/agents/docs/code-review/rubrics/qa.md → .agents/docs/code-review/rubrics/qa.md b/agents/docs/code-review/rubrics/qa.md → .agents/docs/code-review/rubrics/qa.md
diff --git a/agents/docs/code-review/rubrics/sdk.md → .agents/docs/code-review/rubrics/sdk.md b/agents/docs/code-review/rubrics/sdk.md → .agents/docs/code-review/rubrics/sdk.md
diff --git a/agents/docs/code-review/rubrics/security.md → .agents/docs/code-review/rubrics/security.md b/agents/docs/code-review/rubrics/security.md → .agents/docs/code-review/rubrics/security.md
diff --git a/agents/docs/code-review/rubrics/services.md → .agents/docs/code-review/rubrics/services.md b/agents/docs/code-review/rubrics/services.md → .agents/docs/code-review/rubrics/services.md
diff --git a/...s/docs/code-review/rubrics/testability.md → ...s/docs/code-review/rubrics/testability.md b/...s/docs/code-review/rubrics/testability.md → ...s/docs/code-review/rubrics/testability.md
diff --git a/agents/docs/code-review/rubrics/web.md → .agents/docs/code-review/rubrics/web.md b/agents/docs/code-review/rubrics/web.md → .agents/docs/code-review/rubrics/web.md
diff --git a/...ts/docs/code-review/templates/findings.md → ...ts/docs/code-review/templates/findings.md b/...ts/docs/code-review/templates/findings.md → ...ts/docs/code-review/templates/findings.md
diff --git a/.../docs/code-review/templates/metadata.json → .../docs/code-review/templates/metadata.json b/.../docs/code-review/templates/metadata.json → .../docs/code-review/templates/metadata.json
diff --git a/agents/docs/code-review/templates/plan.md → .agents/docs/code-review/templates/plan.md b/agents/docs/code-review/templates/plan.md → .agents/docs/code-review/templates/plan.md
diff --git a/...ts/docs/code-review/templates/progress.md → ...ts/docs/code-review/templates/progress.md b/...ts/docs/code-review/templates/progress.md → ...ts/docs/code-review/templates/progress.md
diff --git a/...s/docs/code-review/templates/questions.md → ...s/docs/code-review/templates/questions.md b/...s/docs/code-review/templates/questions.md → ...s/docs/code-review/templates/questions.md
diff --git a/agents/docs/code-review/templates/risks.md → .agents/docs/code-review/templates/risks.md b/agents/docs/code-review/templates/risks.md → .agents/docs/code-review/templates/risks.md
diff --git a/agents/docs/code-review/templates/scope.md → .agents/docs/code-review/templates/scope.md b/agents/docs/code-review/templates/scope.md → .agents/docs/code-review/templates/scope.md
diff --git a/...s/docs/code-review/templates/scorecard.md → ...s/docs/code-review/templates/scorecard.md b/...s/docs/code-review/templates/scorecard.md → ...s/docs/code-review/templates/scorecard.md
diff --git a/agents/docs/code-review/templates/summary.md → ...nts/docs/code-review/templates/summary.md b/agents/docs/code-review/templates/summary.md → ...nts/docs/code-review/templates/summary.md
diff --git a/agents/docs/diataxis/initial.digest.md → .agents/docs/diataxis/initial.digest.md b/agents/docs/diataxis/initial.digest.md → .agents/docs/diataxis/initial.digest.md
diff --git a/agents/skills/README.md → .agents/skills/README.md b/agents/skills/README.md → .agents/skills/README.md
@@ -56,14 +56,14 @@ Code + Docs -- scan-codebase --> Findings <-- test-codebase -- Tests / Runtime /
 For Codex:
 
 - invoke a skill with `$skill-name`
-- `agents/skills/` is the canonical source, but Codex auto-discovers from `~/.codex/skills`
+- `.agents/skills/` is the canonical source, but Codex auto-discovers from `~/.codex/skills`
 - if a skill does not appear under `$`, refresh the symlink or install it into `~/.codex/skills` and reload Codex
 
 For Claude:
 
 - invoke a project skill with `/project:skill-name` when your Claude client exposes project skills that way
 - otherwise use the Claude project skills picker after reloading the project
-- `.claude/skills/` contains the Claude-facing wrappers for the canonical skills in `agents/skills/`
+- `.claude/skills/` contains the Claude-facing wrappers for the canonical skills in `.agents/skills/`
 
 ## Skills
 

diff --git a/agents/skills/resolve-findings/SKILL.md → .agents/skills/resolve-findings/SKILL.md b/agents/skills/resolve-findings/SKILL.md → .agents/skills/resolve-findings/SKILL.md
diff --git a/...kills/resolve-findings/agents/openai.yaml → ...kills/resolve-findings/agents/openai.yaml b/...kills/resolve-findings/agents/openai.yaml → ...kills/resolve-findings/agents/openai.yaml
diff --git a/agents/skills/scan-codebase/SKILL.md → .agents/skills/scan-codebase/SKILL.md b/agents/skills/scan-codebase/SKILL.md → .agents/skills/scan-codebase/SKILL.md
diff --git a/...s/skills/scan-codebase/agents/openai.yaml → ...s/skills/scan-codebase/agents/openai.yaml b/...s/skills/scan-codebase/agents/openai.yaml → ...s/skills/scan-codebase/agents/openai.yaml
diff --git a/...s/shared/references/findings.lifecycle.md → ...s/shared/references/findings.lifecycle.md b/...s/shared/references/findings.lifecycle.md → ...s/shared/references/findings.lifecycle.md
diff --git a/...ills/shared/references/findings.schema.md → ...ills/shared/references/findings.schema.md b/...ills/shared/references/findings.schema.md → ...ills/shared/references/findings.schema.md
diff --git a/agents/skills/sync-findings/SKILL.md → .agents/skills/sync-findings/SKILL.md b/agents/skills/sync-findings/SKILL.md → .agents/skills/sync-findings/SKILL.md
diff --git a/...s/skills/sync-findings/agents/openai.yaml → ...s/skills/sync-findings/agents/openai.yaml b/...s/skills/sync-findings/agents/openai.yaml → ...s/skills/sync-findings/agents/openai.yaml
diff --git a/agents/skills/test-codebase/SKILL.md → .agents/skills/test-codebase/SKILL.md b/agents/skills/test-codebase/SKILL.md → .agents/skills/test-codebase/SKILL.md
diff --git a/...s/skills/test-codebase/agents/openai.yaml → ...s/skills/test-codebase/agents/openai.yaml b/...s/skills/test-codebase/agents/openai.yaml → ...s/skills/test-codebase/agents/openai.yaml
diff --git a/agents/skills/triage-findings/SKILL.md → .agents/skills/triage-findings/SKILL.md b/agents/skills/triage-findings/SKILL.md → .agents/skills/triage-findings/SKILL.md
diff --git a/...skills/triage-findings/agents/openai.yaml → ...skills/triage-findings/agents/openai.yaml b/...skills/triage-findings/agents/openai.yaml → ...skills/triage-findings/agents/openai.yaml
diff --git a/.claude/skills/resolve-findings b/.claude/skills/resolve-findings
@@ -0,0 +1 @@
+../../.agents/skills/resolve-findings
diff --git a/.claude/skills/scan-codebase b/.claude/skills/scan-codebase
@@ -0,0 +1 @@
+../../.agents/skills/scan-codebase
diff --git a/.claude/skills/sync-findings b/.claude/skills/sync-findings
@@ -0,0 +1 @@
+../../.agents/skills/sync-findings
diff --git a/.claude/skills/test-codebase b/.claude/skills/test-codebase
@@ -0,0 +1 @@
+../../.agents/skills/test-codebase
diff --git a/.claude/skills/triage-findings b/.claude/skills/triage-findings
@@ -0,0 +1 @@
+../../.agents/skills/triage-findings
diff --git a/.gitignore b/.gitignore
@@ -118,6 +118,11 @@ services/runner/tests/results/
 !.claude/skills/write-pr-description
 !.claude/skills/write-social-announcement
 !.claude/skills/write-template-playbooks
+!.claude/skills/scan-codebase
+!.claude/skills/triage-findings
+!.claude/skills/resolve-findings
+!.claude/skills/sync-findings
+!.claude/skills/test-codebase
 
 # Temporary SDK copies created by run.sh --local
 api/sdks

diff --git a/AGENTS.md b/AGENTS.md
@@ -23,7 +23,7 @@ bottom.
 - Package vs app placement, `@agenta/*` packages, package unit tests: the
   `agenta-package-practices` skill.
 - Testing: [docs/designs/testing/README.md](docs/designs/testing/README.md).
-- Docs writing: the Diátaxis framework digest at `agents/docs/diataxis/`, and the
+- Docs writing: the Diátaxis framework digest at `.agents/docs/diataxis/`, and the
   `write-docs` skill for Agenta style, voice, and structure.
 
 ## Branching and PRs with GitButler

diff --git a/docs/design/prompt-runtime-unification/findings.md b/docs/design/prompt-runtime-unification/findings.md
@@ -12,8 +12,8 @@
 - GitHub issue `#4244`: `https://github.com/Agenta-AI/agenta/issues/4244`
 - GitHub review comments fetched through the GitHub plugin comment surface on `2026-05-01`
 - Shared findings references:
-  - `agents/skills/shared/references/findings.schema.md`
-  - `agents/skills/shared/references/findings.lifecycle.md`
+  - `.agents/skills/shared/references/findings.schema.md`
+  - `.agents/skills/shared/references/findings.lifecycle.md`
 - Local implementation:
   - `docs/design/prompt-runtime-unification/README.md`
   - `docs/design/prompt-runtime-unification/appendix-rendering-edge-cases.md`

diff --git a/docs/designs/support-fields/findings.md b/docs/designs/support-fields/findings.md
@@ -40,7 +40,7 @@ Sync-derived findings (closed):
 
 ## Rules
 
-- Severity scheme: `P0` / `P1` / `P2` / `P3` (per [findings.schema.md](../../../agents/skills/shared/references/findings.schema.md)).
+- Severity scheme: `P0` / `P1` / `P2` / `P3` (per [findings.schema.md](../../../.agents/skills/shared/references/findings.schema.md)).
 
 ## Notes