From 2ec1ecfd5000631e69c9429f695ab560f7697453 Mon Sep 17 00:00:00 2001 From: Ed_ Date: Mon, 23 Feb 2026 12:48:09 -0500 Subject: [PATCH] docs(workflow): Automate phase verification protocol with API hooks --- conductor/workflow.md | 40 +++++++++++++--------------------------- 1 file changed, 13 insertions(+), 27 deletions(-) diff --git a/conductor/workflow.md b/conductor/workflow.md index 6f9cfd8..42256a4 100644 --- a/conductor/workflow.md +++ b/conductor/workflow.md @@ -86,34 +86,20 @@ All tasks follow a strict lifecycle: - Execute the announced command. - If tests fail, you **must** inform the user and begin debugging. You may attempt to propose a fix a **maximum of two times**. If the tests still fail after your second proposed fix, you **must stop**, report the persistent failure, and ask the user for guidance. -4. **Propose a Detailed, Actionable Manual Verification Plan:** - - **CRITICAL:** To generate the plan, first analyze `product.md`, `product-guidelines.md`, and `plan.md` to determine the user-facing goals of the completed phase. - - You **must** generate a step-by-step plan that walks the user through the verification process, including any necessary commands and specific, expected outcomes. - - The plan you present to the user **must** follow this format: +4. **Execute Automated API Hook Verification:** + - **CRITICAL:** The Conductor agent will now automatically execute verification tasks using the application's API hooks. + - The agent will announce the start of the automated verification to the user. + - It will then communicate with the application's IPC server to trigger the necessary verification functions. + - **Result Handling:** + - All results (successes and failures) from the API hook invocations will be logged. + - If all automated verifications pass, the agent will inform the user and proceed to the next step (Create Checkpoint Commit). + - If any automated verification fails, the agent will halt the workflow, present the detailed failure logs to the user, and await further instructions for debugging or remediation. - **For a Frontend Change:** - ``` - The automated tests have passed. For manual verification, please follow these steps: - - **Manual Verification Steps:** - 1. **Start the development server with the command:** `npm run dev` - 2. **Open your browser to:** `http://localhost:3000` - 3. **Confirm that you see:** The new user profile page, with the user's name and email displayed correctly. - ``` - - **For a Backend Change:** - ``` - The automated tests have passed. For manual verification, please follow these steps: - - **Manual Verification Steps:** - 1. **Ensure the server is running.** - 2. **Execute the following command in your terminal:** `curl -X POST http://localhost:8080/api/v1/users -d '{"name": "test"}'` - 3. **Confirm that you receive:** A JSON response with a status of `201 Created`. - ``` - -5. **Await Explicit User Feedback:** - - After presenting the detailed plan, ask the user for confirmation: "**Does this meet your expectations? Please confirm with yes or provide feedback on what needs to be changed.**" - - **PAUSE** and await the user's response. Do not proceed without an explicit yes or confirmation. +5. **Present Automated Verification Results and User Confirmation:** + - After executing automated verification, the Conductor agent will present the results to the user. + - If verification passed, the agent will state: "Automated verification completed successfully." + - If verification failed, the agent will state: "Automated verification failed. Please review the logs above for details. You may attempt to propose a fix a **maximum of two times**. If the tests still fail after your second proposed fix, you **must stop**, report the persistent failure, and ask the user for guidance." + - **PAUSE** and await the user's response. Do not proceed without an explicit yes or confirmation from the user to proceed if tests pass, or guidance if tests fail. 6. **Create Checkpoint Commit:** - Stage all changes. If no changes occurred in this step, proceed with an empty commit.