diff --git a/.agents/skills/planning-with-files/templates/analytics_task_plan.md b/.agents/skills/planning-with-files/templates/analytics_task_plan.md index 7e9448e..baba651 100644 --- a/.agents/skills/planning-with-files/templates/analytics_task_plan.md +++ b/.agents/skills/planning-with-files/templates/analytics_task_plan.md @@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence. [One sentence describing the analytical objective] +## Next Step + +Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes. + +[The single next analytical action. Update whenever phase status changes.] + ## Current Phase Name the phase currently being worked on. @@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a ## Notes - Update phase status as work progresses: `pending` to `in_progress` to `complete`. -- Re-read the goal and current phase before major analytical decisions. +- Re-read the goal, next step, and current phase before major analytical decisions. - Log errors promptly so failed approaches are not repeated. - Record query results and visual evidence in findings.md. diff --git a/.codebuddy/skills/planning-with-files/templates/analytics_task_plan.md b/.codebuddy/skills/planning-with-files/templates/analytics_task_plan.md index 7e9448e..baba651 100644 --- a/.codebuddy/skills/planning-with-files/templates/analytics_task_plan.md +++ b/.codebuddy/skills/planning-with-files/templates/analytics_task_plan.md @@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence. [One sentence describing the analytical objective] +## Next Step + +Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes. + +[The single next analytical action. Update whenever phase status changes.] + ## Current Phase Name the phase currently being worked on. @@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a ## Notes - Update phase status as work progresses: `pending` to `in_progress` to `complete`. -- Re-read the goal and current phase before major analytical decisions. +- Re-read the goal, next step, and current phase before major analytical decisions. - Log errors promptly so failed approaches are not repeated. - Record query results and visual evidence in findings.md. diff --git a/.codex/skills/planning-with-files/templates/analytics_task_plan.md b/.codex/skills/planning-with-files/templates/analytics_task_plan.md index 7e9448e..baba651 100644 --- a/.codex/skills/planning-with-files/templates/analytics_task_plan.md +++ b/.codex/skills/planning-with-files/templates/analytics_task_plan.md @@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence. [One sentence describing the analytical objective] +## Next Step + +Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes. + +[The single next analytical action. Update whenever phase status changes.] + ## Current Phase Name the phase currently being worked on. @@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a ## Notes - Update phase status as work progresses: `pending` to `in_progress` to `complete`. -- Re-read the goal and current phase before major analytical decisions. +- Re-read the goal, next step, and current phase before major analytical decisions. - Log errors promptly so failed approaches are not repeated. - Record query results and visual evidence in findings.md. diff --git a/.cursor/skills/planning-with-files/templates/analytics_task_plan.md b/.cursor/skills/planning-with-files/templates/analytics_task_plan.md index 7e9448e..baba651 100644 --- a/.cursor/skills/planning-with-files/templates/analytics_task_plan.md +++ b/.cursor/skills/planning-with-files/templates/analytics_task_plan.md @@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence. [One sentence describing the analytical objective] +## Next Step + +Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes. + +[The single next analytical action. Update whenever phase status changes.] + ## Current Phase Name the phase currently being worked on. @@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a ## Notes - Update phase status as work progresses: `pending` to `in_progress` to `complete`. -- Re-read the goal and current phase before major analytical decisions. +- Re-read the goal, next step, and current phase before major analytical decisions. - Log errors promptly so failed approaches are not repeated. - Record query results and visual evidence in findings.md. diff --git a/.factory/skills/planning-with-files/templates/analytics_task_plan.md b/.factory/skills/planning-with-files/templates/analytics_task_plan.md index 7e9448e..baba651 100644 --- a/.factory/skills/planning-with-files/templates/analytics_task_plan.md +++ b/.factory/skills/planning-with-files/templates/analytics_task_plan.md @@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence. [One sentence describing the analytical objective] +## Next Step + +Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes. + +[The single next analytical action. Update whenever phase status changes.] + ## Current Phase Name the phase currently being worked on. @@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a ## Notes - Update phase status as work progresses: `pending` to `in_progress` to `complete`. -- Re-read the goal and current phase before major analytical decisions. +- Re-read the goal, next step, and current phase before major analytical decisions. - Log errors promptly so failed approaches are not repeated. - Record query results and visual evidence in findings.md. diff --git a/.gemini/skills/planning-with-files/templates/analytics_task_plan.md b/.gemini/skills/planning-with-files/templates/analytics_task_plan.md index 7e9448e..baba651 100644 --- a/.gemini/skills/planning-with-files/templates/analytics_task_plan.md +++ b/.gemini/skills/planning-with-files/templates/analytics_task_plan.md @@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence. [One sentence describing the analytical objective] +## Next Step + +Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes. + +[The single next analytical action. Update whenever phase status changes.] + ## Current Phase Name the phase currently being worked on. @@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a ## Notes - Update phase status as work progresses: `pending` to `in_progress` to `complete`. -- Re-read the goal and current phase before major analytical decisions. +- Re-read the goal, next step, and current phase before major analytical decisions. - Log errors promptly so failed approaches are not repeated. - Record query results and visual evidence in findings.md. diff --git a/.hermes/skills/planning-with-files/templates/analytics_task_plan.md b/.hermes/skills/planning-with-files/templates/analytics_task_plan.md index 8e3d70d..e6276ca 100644 --- a/.hermes/skills/planning-with-files/templates/analytics_task_plan.md +++ b/.hermes/skills/planning-with-files/templates/analytics_task_plan.md @@ -8,6 +8,12 @@ State what the analysis should determine or produce in one clear sentence. [One sentence describing the analytical objective] +## Next Step + +Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes. + +[The single next analytical action. Update whenever phase status changes.] + ## Current Phase Name the phase currently being worked on. @@ -84,6 +90,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a ## Notes - Update phase status as work progresses: `pending` to `in_progress` to `complete`. -- Re-read the goal and current phase before major analytical decisions. +- Re-read the goal, next step, and current phase before major analytical decisions. - Log errors promptly so failed approaches are not repeated. - Record query results and visual findings in findings.md while the evidence is available. diff --git a/.opencode/skills/planning-with-files/templates/analytics_task_plan.md b/.opencode/skills/planning-with-files/templates/analytics_task_plan.md index 7e9448e..baba651 100644 --- a/.opencode/skills/planning-with-files/templates/analytics_task_plan.md +++ b/.opencode/skills/planning-with-files/templates/analytics_task_plan.md @@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence. [One sentence describing the analytical objective] +## Next Step + +Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes. + +[The single next analytical action. Update whenever phase status changes.] + ## Current Phase Name the phase currently being worked on. @@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a ## Notes - Update phase status as work progresses: `pending` to `in_progress` to `complete`. -- Re-read the goal and current phase before major analytical decisions. +- Re-read the goal, next step, and current phase before major analytical decisions. - Log errors promptly so failed approaches are not repeated. - Record query results and visual evidence in findings.md. diff --git a/.pi/skills/planning-with-files/templates/analytics_task_plan.md b/.pi/skills/planning-with-files/templates/analytics_task_plan.md index 7e9448e..baba651 100644 --- a/.pi/skills/planning-with-files/templates/analytics_task_plan.md +++ b/.pi/skills/planning-with-files/templates/analytics_task_plan.md @@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence. [One sentence describing the analytical objective] +## Next Step + +Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes. + +[The single next analytical action. Update whenever phase status changes.] + ## Current Phase Name the phase currently being worked on. @@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a ## Notes - Update phase status as work progresses: `pending` to `in_progress` to `complete`. -- Re-read the goal and current phase before major analytical decisions. +- Re-read the goal, next step, and current phase before major analytical decisions. - Log errors promptly so failed approaches are not repeated. - Record query results and visual evidence in findings.md. diff --git a/skills/planning-with-files/templates/analytics_task_plan.md b/skills/planning-with-files/templates/analytics_task_plan.md index 7e9448e..baba651 100644 --- a/skills/planning-with-files/templates/analytics_task_plan.md +++ b/skills/planning-with-files/templates/analytics_task_plan.md @@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence. [One sentence describing the analytical objective] +## Next Step + +Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes. + +[The single next analytical action. Update whenever phase status changes.] + ## Current Phase Name the phase currently being worked on. @@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a ## Notes - Update phase status as work progresses: `pending` to `in_progress` to `complete`. -- Re-read the goal and current phase before major analytical decisions. +- Re-read the goal, next step, and current phase before major analytical decisions. - Log errors promptly so failed approaches are not repeated. - Record query results and visual evidence in findings.md. diff --git a/templates/analytics_task_plan.md b/templates/analytics_task_plan.md index 7e9448e..baba651 100644 --- a/templates/analytics_task_plan.md +++ b/templates/analytics_task_plan.md @@ -8,6 +8,12 @@ State the analytical question or intended deliverable in one clear sentence. [One sentence describing the analytical objective] +## Next Step + +Record the single analytical action that should happen next. Update it whenever the active phase or immediate action changes. + +[The single next analytical action. Update whenever phase status changes.] + ## Current Phase Name the phase currently being worked on. @@ -76,6 +82,6 @@ Record each distinct error, the attempt number, and the resolution. Change the a ## Notes - Update phase status as work progresses: `pending` to `in_progress` to `complete`. -- Re-read the goal and current phase before major analytical decisions. +- Re-read the goal, next step, and current phase before major analytical decisions. - Log errors promptly so failed approaches are not repeated. - Record query results and visual evidence in findings.md. diff --git a/tests/test_init_session_slug.py b/tests/test_init_session_slug.py index f6beeea..f86700d 100644 --- a/tests/test_init_session_slug.py +++ b/tests/test_init_session_slug.py @@ -115,6 +115,25 @@ class InitSessionSlugTests(unittest.TestCase): self.assertTrue((root / "task_plan.md").exists()) self.assertFalse((root / ".planning").exists()) + def test_named_analytics_plan_has_a_nonempty_next_step(self) -> None: + with tempfile.TemporaryDirectory() as tmp: + root = Path(tmp) + result = self.run_init(root, "--template", "analytics", "Analytics Run") + self.assertEqual(0, result.returncode, result.stderr) + plan = ( + root + / ".planning" + / f"{date.today().isoformat()}-analytics-run" + / "task_plan.md" + ).read_text(encoding="utf-8") + section = re.search( + r"(?ms)^## Next Step\s*\n(?P.*?)(?=^## |\Z)", + plan, + ) + self.assertIsNotNone(section) + assert section is not None + self.assertTrue(section.group("body").strip()) + def test_slug_init_replaces_hardlinked_pointer_without_mutating_peer(self) -> None: with tempfile.TemporaryDirectory() as tmp: root = Path(tmp) diff --git a/tests/test_template_transparency.py b/tests/test_template_transparency.py index 76fcc91..fc5df1e 100644 --- a/tests/test_template_transparency.py +++ b/tests/test_template_transparency.py @@ -3,6 +3,7 @@ from __future__ import annotations import os +import re import subprocess import tempfile import unittest @@ -101,6 +102,8 @@ class TemplateTransparencyTests(unittest.TestCase): ), "analytics_task_plan.md": ( "[One sentence describing the analytical objective]", + "## Next Step", + "[The single next analytical action. Update whenever phase status changes.]", "## Current Phase", "## Phases", "## Hypotheses", @@ -126,6 +129,28 @@ class TemplateTransparencyTests(unittest.TestCase): self.assertEqual(1, analytics_plan.count("- **Status:** in_progress")) self.assertEqual(3, analytics_plan.count("- **Status:** pending")) + def test_shipped_task_plan_templates_have_a_nonempty_next_step_section(self) -> None: + analytics_paths = [ + path + for path in tracked_install_facing_templates() + if path.name == "analytics_task_plan.md" + ] + self.assertTrue(analytics_paths, "no shipped analytics task plan templates found") + paths = [CANONICAL_TEMPLATES / "task_plan.md", *analytics_paths] + for path in paths: + with self.subTest(path=path): + body = self.read_template(path) + section = re.search( + r"(?ms)^## Next Step\s*\n(?P.*?)(?=^## |\Z)", + body, + ) + self.assertIsNotNone(section, f"{path} is missing ## Next Step") + assert section is not None + self.assertTrue( + section.group("body").strip(), + f"{path} has an empty ## Next Step section", + ) + def test_autonomous_template_names_the_real_gate_authority(self) -> None: body = self.read_template(CANONICAL_TEMPLATES / "task_plan_autonomous.md") for required in (