[gem-team] New Agents + magic keywords + coverage tracking + contract checks (#1227)

* feat(orchestrator): add Discuss Phase and PRD creation workflow

- Introduce Discuss Phase for medium/complex objectives, generating context‑aware options and logging architectural decisions
- Add PRD creation step after discussion, storing the PRD in docs/prd.yaml
- Refactor Phase 1 to pass task clarifications to researchers
- Update Phase 2 planning to include multi‑plan selection for complex tasks and verification with gem‑reviewer
- Enhance Phase 3 execution loop with wave integration checks and conflict filtering

* feat(gem-team): bump version to 1.3.3 and refine description with Discuss Phase and PRD compliance verification

* chore(release): bump marketplace version to 1.3.4

- Update `marketplace.json` version from `1.3.3` to `1.3.4`.
- Refine `gem-browser-tester.agent.md`:
  - Replace "UUIDs" typo with correct spelling.
  - Adjust wording and formatting for clarity.
  - Update JSON code fences to use ````jsonc````.
  - Modify workflow description to reference `AGENTS.md` when present.
- Refine `gem-devops.agent.md`:
  - Align expertise list formatting.
  - Standardize tool list syntax with back‑ticks.
  - Minor wording improvements.
- Increase retry attempts in `gem-browser-tester.agent.md` from 2 to 3 attempts.
- Minor typographical and formatting corrections across agent documentation.

* refactor: rename prd_path to project_prd_path in agent configurations

- Updated gem-orchestrator.agent.md to use `project_prd_path` instead of `prd_path` in task definitions and delegation logic.
- Updated gem-planner.agent.md to reference `project_prd_path` and clarify PRD reading.
- Updated gem-researcher.agent.md to use `project_prd_path` and adjust PRD consumption logic.
- Applied minor wording improvements and consistency fixes across the orchestrator, planner, and researcher documentation.

* feat(plugin): expand marketplace description, bump version to 1.4.0; revamp gem-browser-tester agent documentation with clearer role, expertise, and workflow specifications.

* chore: remove outdated plugin metadata fields from README.plugins.md and plugin.json

* feat(tooling): bump marketplace version to 1.5.0 and refine validation thresholds

- Update marketplace.json version from 1.4.0 to 1.5.0
- Adjust validation criteria in gem-browser-tester.agent.md to trigger additional tests when coverage < 0.85 or confidence < 0.85
- Refine accessibility compliance description, adding runtime validation and SPEC‑based accessibility notes- Add new gem-code-simplifier.agent.md documentation for code refactoring
- Update README and plugin metadata to reflect version change and new tooling

* docs: improve bug‑fix delegation description and delegation‑first guidance in gem‑orchestrator.agent.md

- Clarified the two‑step diagnostic‑then‑fix flow for bug fixes using gem‑debugger and gem‑implementer.
- Updated the “Delegation First” checklist to stress that **no** task, however small, should be performed directly by the orchestrator, emphasizing sub‑agent delegation and retry/escalation strategy.

---------

Co-authored-by: Aaron Powell <me@aaron-powell.com>

agents/gem-reviewer.agent.md

@@ -63,6 +63,12 @@ By Depth:
 
 ### 2.4 Output
 - Return JSON per `Output Format`
+- Include architectural checks for plan scope:
+  extra:
+    architectural_checks:
+      simplicity: pass | fail
+      anti_abstraction: pass | fail
+      integration_first: pass | fail
 
 ## 3. Wave Scope
 ### 3.1 Analyze
@@ -78,6 +84,12 @@ By Depth:
 
 ### 3.3 Report
 - Per-check status (pass/fail), affected files, error summaries
+- Include contract checks:
+  extra:
+    contract_checks:
+      - from_task: string
+        to_task: string
+        status: pass | fail
 
 ### 3.4 Determine Status
 - IF any check fails: Mark as failed.
@@ -103,6 +115,15 @@ By Depth:
 - Verify logic against specification AND PRD compliance (including error codes)
 
 ### 4.5 Verify
+- Include task completion check fields in output for task scope:
+  extra:
+    task_completion_check:
+      files_created: [string]
+      files_exist: pass | fail
+    coverage_status:
+      acceptance_criteria_met: [string]
+      acceptance_criteria_missing: [string]
+
 - Security audit, code quality, logic verification, PRD compliance per plan and error code consistency
 
 ### 4.6 Self-Critique (Reflection)
@@ -158,7 +179,7 @@ By Depth:
         "location": "string"
       }
     ],
-    "quality_issues": [
+    "code_quality_issues": [
       {
         "severity": "critical|high|medium|low",
         "category": "string",