hoangsonww/bead-workflow
.agents/skills/bead-workflow/SKILL.md
Execute the Flywheel bead lifecycle — find, claim, implement, review, close
$ install --global
skillsauthnpx skillsauth add hoangsonww/WealthWise-Finance-Tracker bead-workflowInstall 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, 7:50 PM10.4s1 file scanned
SKILL.md
- name:
- bead-workflow
- trigger:
- $bead-workflow [bead-id]
- description:
- Execute the Flywheel bead lifecycle — find, claim, implement, review, close
Bead Workflow Skill
Execute the Agentic Coding Flywheel bead lifecycle.
Usage
$bead-workflow # Find and work on the next highest-leverage bead
$bead-workflow br-021 # Work on a specific bead
Process
- Find: Use
bv --robot-triageor read.beads/issues.jsonl+.beads/deps.jsonlto find unblocked beads - Claim: Mark as
in_progress, announce via Agent Mail thread[br-XXX] - Reserve: Reserve target files in
.agent-sessions/mail/reservations.jsonl - Implement: Follow bead body (Context → What to Do → Acceptance Criteria → Files to Modify)
- Review: Self-review with fresh eyes, fix bugs, run tests
- Close: Mark as closed, announce completion, release reservations
- Commit:
git commit -m "[br-XXX] <description>"then push - Next: Use
bv --robot-nextto find the next bead
Conventions
- Reference bead IDs in all commits, messages, and reservations
- Follow package-specific conventions from AGENTS.md
- Run
npx turbo test --filter=@wealthwise/<package>before closing - If bead is too large, split into sub-beads first
Related Skills
hoangsonww/test-coverage
development
VerifiedTrustedCommunity
Run the WealthWise test suite with coverage reporting and summarize the results. Triggers when asked to "run tests with coverage", "check test coverage", "show coverage report", or "how many tests pass". Can be scoped to api, web, or types.
12SKILL.mdUpdated Apr 16, 2026
hoangsonww/pre-pr
testing
VerifiedTrustedCommunity
Run the full WealthWise pre-PR checklist and report a pass/fail for each gate. Triggers when asked to "run pre-PR checks", "check if this is ready to merge", "validate before opening a PR", or "run the full check". Does NOT trigger implicitly.
12SKILL.mdUpdated Apr 16, 2026
hoangsonww/new-page
development
VerifiedTrustedCommunity
Scaffold a complete new Next.js dashboard page for the WealthWise web app. Triggers when asked to "add a page", "create a dashboard screen", "build a UI for <feature>", or scaffold any new frontend feature end-to-end. Does not trigger for API-only or backend tasks.
12SKILL.mdUpdated Apr 16, 2026
hoangsonww/new-model
development
VerifiedTrustedCommunity
Scaffold a new Mongoose model and its CRUD service for the WealthWise API. Triggers when asked to "create a model", "add a Mongoose schema", or add the data layer for a new entity without a full endpoint. Does NOT scaffold routes, controllers, or frontend code. Use $api-endpoint for the full stack.
12SKILL.mdUpdated Apr 16, 2026