ricky-yosh/bf-save-progress
skills/brownfield/bf-save-progress/SKILL.md
Save current session work to .aw/brownfield-progress/progress.txt in the current worktree. Captures decisions (why, not just what) that git diff cannot show. Part of the brownfield skill family. Use when the user says /bf-save-progress, wants to capture session state, or is wrapping up work on a ticket.
testing
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add ricky-yosh/agent-workflows bf-save-progressInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 8:38 PM14.9s1 file scanned
SKILL.md
- name:
- bf-save-progress
- description:
- Save current session work to .aw/brownfield-progress/progress.txt in the current worktree. Captures decisions (why, not just what) that git diff cannot show. Part of the brownfield skill family. Use when the user says /bf-save-progress, wants to capture session state, or is wrapping up work on a ticket.
- model:
- sonnet
Save Progress (Brownfield)
Capture this session's work into .aw/brownfield-progress/progress.txt.
Steps
-
Read
.aw/brownfield-progress/progress.txtif it exists — display the last session entry so the user can see what was previously recorded. -
Read
.aw/brownfield-progress/tasks.jsonif it exists — identify which tasks were completed this session. -
Review the conversation to identify what was accomplished this session.
-
If anything is ambiguous, ask the user: "I saw [X] and [Y] — anything else to capture, or anything I got wrong?"
-
Ask: "Which tasks were completed this session?" Show the remaining (not done) tasks from tasks.json for the user to confirm. Mark confirmed tasks as
"done": trueand write the updated tasks.json back. -
Update
progress.txt: read the full existing file, then write back the entire contents with the new entry appended at the end. Do not use a method that overwrites without preserving existing content.
## Session — YYYY-MM-DD
### Accomplished
- ...
### Decisions Made
- ... (capture *why*, not just *what* — this is what git diff cannot show)
### Next Steps
- ...
### Blockers
- ...
-
Confirm what was appended and which tasks were marked done.
-
Run
/create-git-commitsto commit all current changes.
Principles
- Decisions over actions. "Decided to use retry wrapper instead of inline retry because multiple callers share the same handler" is more valuable than "modified upload.ts".
- Be specific about blockers. A vague "needs investigation" helps no one next session. Name the symbol, file, or behavior that's unclear.
Related Skills
ricky-yosh/gf-write-tests
development
VerifiedTrustedCommunity
Write tests for a batch of tasks BEFORE implementation. Detects the project's test framework and language, then writes tests that cover happy paths, edge cases, and failure modes. All tests should fail initially since there is no implementation yet. Part of the gf (greenfield) skill family. Use when the user says /gf-write-tests or wants to write tests before implementing a feature or task batch.
SKILL.mdUpdated Apr 16, 2026
ricky-yosh/gf-testing-notes
testing
VerifiedTrustedCommunity
Generate readable testing notes after a feature is complete. Compares spec against implementation to produce a concise list of what was built, how to test it, and any scope gaps. Writes testing-notes.md to .aw/greenfield-progress/. Part of the gf (greenfield) skill family.
SKILL.mdUpdated Apr 16, 2026
ricky-yosh/gf-save-progress
testing
VerifiedTrustedCommunity
Save current session work to .aw/greenfield-progress/progress.txt. Captures decisions (why, not just what) that git diff cannot show. Updates tasks.json to mark completed tasks. Part of the gf (greenfield) skill family.
SKILL.mdUpdated Apr 16, 2026
ricky-yosh/gf-review
testing
VerifiedTrustedCommunity
Gate the greenfield workflow on user verification after an implementation step. Reads the implementation digest, shows verification steps, and waits for the user to confirm before advancing. Part of the gf (greenfield) skill family.
SKILL.mdUpdated Apr 16, 2026