refactor: relocate agent-system/ to .agents/ with 7-role workflow restructure

Moves the agent workflow system from agent-system/ to .agents/ (dotfile convention).
Restructured from 5-role to 7-role pipeline: adds Analyst and splits Reviewer into
Code Reviewer + Security Reviewer. Removes all old workflow run artifacts.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

.agents/templates/analysis.template.json

@@ -0,0 +1,32 @@
+{
+  "task_id": "TASK-0001",
+  "issue_summary": "Short summary of the issue or feature request",
+  "affected_layers": ["Service", "pages"],
+  "affected_files": [
+    {
+      "path": "path/to/file.php",
+      "role": "Service that handles X"
+    }
+  ],
+  "existing_patterns": [
+    "Uses app-details-titlebar partial",
+    "Follows PRG pattern in similar actions"
+  ],
+  "related_tests": [
+    "tests/Service/XServiceTest.php"
+  ],
+  "security_surface": {
+    "authz_relevant": false,
+    "tenant_scope_relevant": false,
+    "input_handling": true,
+    "crypto_relevant": false,
+    "file_upload_relevant": false,
+    "notes": ""
+  },
+  "assumptions": [
+    "Assumption the Planner must resolve"
+  ],
+  "risks_discovered": [
+    "Risk discovered during analysis"
+  ]
+}

.agents/templates/execution-report.template.json

@@ -0,0 +1,39 @@
+{
+  "task_id": "TASK-0001",
+  "plan_ref": ".agents/runs/TASK-0001/plan.json",
+  "status": "done",
+  "changed_files": [
+    {
+      "path": "path/to/file",
+      "summary": "What changed"
+    }
+  ],
+  "guard_evidence": [
+    {
+      "guard_id": "GR-CORE-003",
+      "status": "pass",
+      "evidence": "Short evidence with file or test reference."
+    }
+  ],
+  "commands": [
+    {
+      "cmd": "docker compose exec php vendor/bin/phpunit",
+      "result": "pass"
+    }
+  ],
+  "quality_gate_results": [
+    {
+      "gate_id": "QG-001",
+      "result": "pass",
+      "notes": ""
+    }
+  ],
+  "test_results": [
+    {
+      "name": "test name",
+      "result": "pass",
+      "notes": ""
+    }
+  ],
+  "open_items": []
+}

.agents/templates/finalize.template.json

@@ -0,0 +1,12 @@
+{
+  "task_id": "TASK-0001",
+  "ready_to_finalize": false,
+  "code_review": "pass",
+  "security_review": "pass",
+  "acceptance_review": "pass",
+  "ci_status": "unknown",
+  "final_action": "hold",
+  "hold_reason": "Waiting for all three reviews and quality gates to pass.",
+  "commit_message": "",
+  "notes": ""
+}

.agents/templates/plan.template.json

@@ -0,0 +1,50 @@
+{
+  "task_id": "TASK-0001",
+  "analysis_ref": ".agents/runs/TASK-0001/analysis.json",
+  "summary": "Short summary of issue or feature",
+  "assumptions": [],
+  "scope": {
+    "in": [],
+    "out": []
+  },
+  "guardrails": {
+    "required_guard_ids": [
+      "GR-CORE-003",
+      "GR-TEST-001",
+      "GR-SEC-008"
+    ],
+    "required_quality_gate_ids": [
+      "QG-001",
+      "QG-002",
+      "QG-003"
+    ]
+  },
+  "success_criteria": [
+    {
+      "id": "SC-001",
+      "criterion": "Measurable acceptance criterion."
+    }
+  ],
+  "implementation_steps": [
+    {
+      "id": "S1",
+      "title": "Step title",
+      "description": "Step detail",
+      "guard_refs": [
+        "GR-CORE-003"
+      ]
+    }
+  ],
+  "tests": [
+    "Test name or PHPUnit class that proves the feature works"
+  ],
+  "acceptance_checks": [
+    "SC-001: Verifiable acceptance step for criterion SC-001"
+  ],
+  "risks": [
+    {
+      "risk": "Risk description",
+      "mitigation": "Mitigation description"
+    }
+  ]
+}

.agents/templates/review-acceptance.template.json

@@ -0,0 +1,16 @@
+{
+  "task_id": "TASK-0001",
+  "verdict": "pass",
+  "checked_criterion_ids": [
+    "SC-001"
+  ],
+  "checks": [
+    {
+      "criterion_id": "SC-001",
+      "criterion": "criterion text",
+      "result": "pass",
+      "evidence": "Reference to proof (test, file, manual smoke step)."
+    }
+  ],
+  "missing_or_wrong": []
+}

.agents/templates/review-code.template.json

@@ -0,0 +1,14 @@
+{
+  "task_id": "TASK-0001",
+  "verdict": "pass",
+  "checked_guard_ids": [
+    "GR-CORE-003",
+    "GR-TEST-001"
+  ],
+  "checked_quality_gate_ids": [
+    "QG-001",
+    "QG-002",
+    "QG-003"
+  ],
+  "findings": []
+}

.agents/templates/review-security.template.json

@@ -0,0 +1,9 @@
+{
+  "task_id": "TASK-0001",
+  "verdict": "pass",
+  "checked_guard_ids": [
+    "GR-SEC-008",
+    "GR-SEC-009"
+  ],
+  "findings": []
+}