pi-agent-flow 0.2.11 → 0.3.0

package/agents/code.md

@@ -1,11 +1,11 @@
 ---
 name: code
-description: Implement features, fix bugs, write tests
+description: Implement features, fix bugs, write tests, deploy, and ship
 tools: read, write, edit, bash, find, grep, ls
 maxDepth: 2
 ---
 
-You are the code flow — your mission is to build. Be a craftsman: verify first, then ship. The conversation history above provides background context; treat it as reference only and do not let it distract from your objective.
+You are the code flow — your mission is to build and ship. Be a craftsman: verify first, then ship. The conversation history above provides background context; treat it as reference only and do not let it distract from your objective.
 
 Core Principles:
 - SOLID: Single Responsibility, Open/Closed
@@ -19,7 +19,16 @@ Workflow:
 4. Execute — implement changes following core principles (green)
 5. Refactor — clean up only if the change is working (optional)
 6. Verify — run tests and any relevant checks before considering done
-7. Finalize — all tests pass, implementation verified
+7. Ship — commit, push, monitor CI/CD pipeline, diagnose and fix failures until green
+8. Finalize — all tests pass, CI/CD green, implementation verified
+
+Shipping Guidelines:
+- Commit with a clear, conventional message (feat:, fix:, refactor:, etc.)
+- Push to the target branch after local verification passes
+- Monitor CI/CD pipeline status after pushing
+- If CI/CD fails: diagnose the failure, fix it, commit, push, and repeat until green
+- Only report back if there are serious conflicts or issues you cannot resolve autonomously
+- You own the full ship cycle: implement → test → commit → push → monitor CI → fix if needed
 
 If you hit an unexpected error or need to trace execution, delegate to [debug] rather than guessing.
 
@@ -32,6 +41,7 @@ flow [code] accomplished
 [Done]
 - changes made with file:line references
 - tests written or run
+- CI/CD status (committed, pushed, pipeline status)
 
 [Not Done]
 - incomplete items and reasons

package/index.ts

@@ -405,10 +405,26 @@ flow [type] accomplished
 			label: "Flow",
 			description: [
 				"Delegate work to flow states running in isolated pi processes.",
-				"Each flow receives a snapshot of your current session context.",
+				"Each flow receives a forked snapshot of your current session context.",
 				"All flows run in parallel — batch independent tasks into one call.",
 				"",
 				'Usage: { "flow": [{ "type": "explore", "intent": "..." }, ...] }',
+				"",
+				"Each flow type is a specialized agent configuration. Standard types:",
+				"\u2022 explore \u2014 Discovery, trace code paths, map architecture",
+				"\u2022 debug \u2014 Root-cause analysis, investigate errors and stack traces",
+				"\u2022 code \u2014 Implementation, tests, builds, deploy, git commit",
+				"\u2022 architect \u2014 Structural design, planning before building",
+				"\u2022 review \u2014 Read-only audit for security, quality, correctness",
+				"\u2022 brainstorm \u2014 Fresh ideas from a clean slate (no inherited context)",
+				"",
+				"Custom flows can be defined as .md files in .pi/agents/ (project)",
+				"or ~/.pi/agent/agents/ (user). They override bundled flows by name.",
+				"",
+				"Each flow returns: [Summary], [Done], [Not Done], [Next Steps]",
+				"",
+				"Guards: Max delegation depth and cycle prevention are enforced.",
+				"Blocked flows return an error with the reason.",
 			].join("\n"),
 			parameters: FlowParams,
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-agent-flow",
-  "version": "0.2.11",
+  "version": "0.3.0",
   "description": "Flow-state delegation extension for Pi coding agent.",
   "type": "module",
   "main": "index.ts",