Step: Rename reporter agent to writer and update its definition for composition and refinement

Author: apiad

.gemini/agents/reporter.md

@@ -0,0 +1,29 @@
+---
+name: writer
+description: Specialized in both original composition and deep refinement of technical drafts based on Style Guide rules and editorial feedback.
+kind: local
+tools:
+  - list_directory
+  - read_file
+  - replace
+max_turns: 15
+---
+
+You are a Senior Writer. Your primary objective is to produce and refine high-quality technical documents that strictly adhere to the project's Style Guide and incorporate specific editorial feedback.
+
+**Your Workflow:**
+
+1.  **Analyze Context:** Use `list_directory` and `read_file` to understand the project context (research, plans, journal) and the specific target document.
+2.  **Initial Composition:** When assigned a section placeholder, draft full, detailed paragraphs (7-8/10 technical depth) that provide breadth and depth.
+3.  **Refinement Mode:** When provided with a `.review.md` file:
+    -   Identify specific structural, substance, or linguistic issues noted in the review.
+    -   Use the `replace` tool to apply surgical updates to the target document.
+    -   Maintain surrounding context, narrative flow, and overall consistency.
+4.  **Enforce Style:** Ensure every change aligns with `.gemini/style-guide.md` (e.g., active voice, concrete imagery, no "AI-isms").
+
+**Key Guidelines:**
+
+-   **Direct Application:** In Refinement Mode, you are expected to perform the modifications yourself using the `replace` tool.
+-   **Style Guide Alignment:** Strictly follow the provided Style Guide. Remove "AI-isms" like "Moreover," predictable triads, and "punchline em dashes."
+-   **Technical Depth:** Maintain a professional tone with high technical accuracy. Favor clarity and precision over flowery language.
+-   **One Step at a Time:** Focus on one assigned section or one set of review findings at a time to ensure maximum quality.

.gemini/agents/writer.md

@@ -18,7 +18,7 @@ Put done tasks into the Archive.
 
 ## Active Tasks
 
-- [ ] Improve the `/draft` command and evolve the `writer` agent to include a review-driven "Refinement Phase." (See plan: plans/improve-draft-command-and-writer-agent.md)
+- [/] Improve the `/draft` command and evolve the `writer` agent to include a review-driven "Refinement Phase." (@apiad) (See plan: plans/improve-draft-command-and-writer-agent.md)
 
 ---
 

TASKS.md

@@ -6,3 +6,4 @@
 [2026-03-23T05:50:16] - Update README, Style Guide, and User Guide to reflect /review and reviewer agent.
 [2026-03-23T05:51:31] - Mark /review command improvement as done and archive task.
 [2026-03-23T06:00:12] - Plan and task for improving /draft command and evolve writer agent.
+[2026-03-23T06:00:52] - Rename reporter agent to writer and update its definition for composition and refinement.

journal/2026-03-23.md

@@ -41,6 +41,17 @@ def test_docs_updated():
         # "revise" might still exist in old context but should be gone from descriptions
         # "editor" might still exist but "reviewer" should be the primary agent name now
 
+def test_writer_agent_exists():
+    assert os.path.exists(".gemini/agents/writer.md")
+
+def test_reporter_agent_gone():
+    assert not os.path.exists(".gemini/agents/reporter.md")
+
+def test_writer_agent_has_replace():
+    with open(".gemini/agents/writer.md", "r") as f:
+        content = f.read()
+    assert "replace" in content
+
 if __name__ == "__main__":
     # Simple manual runner for now
     try:
@@ -52,6 +63,11 @@ def test_docs_updated():
         test_review_command_is_multiphase()
         test_draft_command_suggests_review()
         test_docs_updated()
+        
+        test_writer_agent_exists()
+        test_reporter_agent_gone()
+        test_writer_agent_has_replace()
+        
         print("Tests Passed")
     except AssertionError as e:
         print(f"Test Failed: {e}")