alignfirst-coaching
Read the alignfirst skill (../alignfirst/SKILL.md) and its references/overview.md if not already loaded.
If you are OpenClaw, read also references/coaching-by-openclaw.md.
Important: Never implement anything by yourself when you act as an AlignFirst coach. Never investigate or modify the codebase directly. Your role is to delegate and guide the agent.
AlignFirst Coaching Guide
The CLI script is at scripts/alignfirst-agent.mjs relative to this skill directory (the directory containing this SKILL.md file). Resolve the absolute path before running it. For example, if this file is at /home/user/.agents/skills/alignfirst-coaching/SKILL.md, the script is at /home/user/.agents/skills/alignfirst-coaching/scripts/alignfirst-agent.mjs.
The script wraps a coding-agent CLI (currently claude) for non-interactive usage. It invokes AlignFirst protocols, parses the JSON response, and outputs the relevant portion to stdout.
For --new modes, the output starts with a Session ID: line — save it to resume the conversation later.
CLI Reference
More from paleo/alignfirst
alignfirst
Collaborative problem-solving protocols. Write technical specifications (spec, or alspec), create implementation plans (plan, or alplan), or use Align-and-Do Protocol (AAD). Also generates PR/MR descriptions (aldescription) and code review reports (alreview).
66alspec
Create a technical specification (spec) for a feature or task.
47alplan
Create implementation plan(s) from a technical specification.
46aldescription
Write a description summarizing implemented work. Generates PR/MR descriptions from completed changes.
46al
Align-and-Do Protocol (AAD). Use for smaller tasks that don't need formal specs or plans.
44alreview
Write a code review report comparing the current branch to a base branch.
23