flywheel-mine-patterns

Mine cass session history for recurring workflows and propose them as new skills or pipeline tweaks.

3|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill flywheel-mine-patterns-burningportra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flywheel-mine-patterns
Source: https://github.com/burningportra/agent-flywheel-plugin/tree/main/skills/flywheel-mine-patterns
Command: npx skills add https://github.com/burningportra/agent-flywheel-plugin --skill flywheel-mine-patterns-burningportra

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Repeated prompts, tool sequences, and error-fix loops accumulate invisibly across agent coding sessions, and teams never codify that tacit knowledge into reusable skills or pipeline improvements. ## Core Features & Use Cases - Ritual detection: Groups user prompts repeated 5+ times across sessions to surface workflows worth automating. - Tool sequence mining: Extracts recurring tool n-grams (e.g., Read → Edit → Bash) appearing across 5+ distinct sessions. - Error-fix loop discovery: Finds failure markers followed by successful retries and pairs them as codification candidates. - Classification and bead creation: Buckets each candidate as a new skill scaffold, an existing-skill refinement, or a pipeline tweak, then creates br beads only after user confirmation. - Use Case: After a long sprint, run the miner over the last 7 days of cass-indexed sessions to get a numbered, evidence-backed list of automation candidates and land the chosen ones as tracked beads. ## Quick Start Ask the agent to mine the last 7 days of cass session history in the current workspace and propose recurring workflows as new skill candidates.

Frequently Asked Questions about flywheel-mine-patterns

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find repeated workflows in my Claude Code session history?

Run the pattern miner over your cass-indexed sessions. It groups user prompts repeated 5+ times, extracts recurring tool trigrams across sessions, and pairs error messages with successful retries to surface codification candidates.

How to mine agent session transcripts with cass?

Verify the index is fresh with cass status --json, then run cass search queries for repeated prompts, export sessions with --include-tools for n-gram analysis, and use cass expand around error hits to confirm fix loops.

Does the pattern miner create skills automatically?

No. It only presents an evidence-backed candidate list and creates br beads after you explicitly pick candidates via a prompt. Actual SKILL.md authoring is handed off to flywheel-refine-skill or claude-md-synthesizer.

What happens if my workspace has few indexed sessions?

If fewer than 5 ritual hits appear at the default threshold, the miner lowers the repeat threshold to 3 and notes it in the evidence. If fewer than 3 candidates meet the evidence bar, it reports that and suggests widening the --days window.

Why does the miner report a stale cass index?

A stale index produces stale candidates, so the skill checks cass status --json for index.fresh before mining. If it is false, run cass index --json first; if cass is unavailable or empty, the skill stops rather than fabricating patterns.