| name | wf-logging-a |
| description | Log decisions, progress, deviations, and discoveries during any workflow phase
|
| metadata | {"source-plugin":"wf","source-skill":"logging-a"} |
Action skill — Structured logging: decisions, progress, deviations, discoveries.
Log Entry
$ARGUMENTS
Record a structured log entry in the active plan doc or decision log.
Log Types
Decision (decision)
Record a decision with rationale in design-docs/plans/{name}/{name}_decisions.md:
## [YYYY-MM-DD] {Decision Title}
Context: {What prompted this decision}
Decision: {What was decided}
Rationale: {Why — include tradeoffs considered}
Impact: {What this changes about the plan or system}
Progress (progress)
Add a timestamped entry to the Progress section of the active plan doc:
- [YYYY-MM-DD HH:MM] {What was completed or what state we're in}
Surprise (surprise)
Record an unexpected discovery in the Surprises section of the active plan doc:
### [YYYY-MM-DD] {What was surprising}
Expected: {What we thought would happen}
Actual: {What actually happened}
Implication: {How this affects the plan or approach}
Deviation (deviation)
Record a deviation from the plan. Adds to both the decision log and the plan doc:
## [YYYY-MM-DD] Deviation: {title}
Original plan: {What the plan doc said}
Actual approach: {What we're doing instead}
Reason: {Why the change was necessary}
Impact: {Effect on remaining milestones}
Process
- Determine which plan is active (scan
design-docs/plans/ for active plans or locate the active plan in the relevant scope)
- Determine log type from arguments or ask
- Gather the relevant information
- Write the entry to the correct location
- Confirm what was logged
