Common Phase Instructions

What problem does it solve?

It standardizes how all workflow phase agents perform file operations, update workflow state, and reference codebase context so actions stay deterministic and the workflow doesn’t drift.

Core Features & Use Cases

• Tool-safe file I/O: Enforces Claude Code native Read/Write/Edit tools for all file operations to prevent brittle or unsafe shell-based manipulation.
• Correct home-path handling: Prohibits ~ expansion and requires absolute paths derived from the home directory, reducing path-related failures.
• Consistent state updates: Requires a repeatable pattern for marking status in-progress/completed and logging errors directly into the workflow state file.
• Context efficiency guidance: Directs agents to read only relevant sections and to avoid embedding full codebase context into subagent prompts.
• Use-case: Keeps multi-step phase agents (e.g., build, review, test) aligned when they coordinate work across iterations and context compaction.

Quick Start

In a workflow phase prompt, instruct the agent to follow the Common Phase Instructions exactly for tool usage, state file updates, and context loading for the current task.