Skip to content

ederfmatos/claude-voice-bridge / .claude/skills/cy-workflow-memory

cy-workflow-memory

Verified

Maintains workflow-scoped task memory for Compozy runs using .compozy/tasks/<name>/memory/ files. Use when a task prompt provides workflow memory paths and requires the agent to read, update, compact, and promote durable context across PRD task executions. Do not use for PR review remediation, global user preferences, or programmatic event-log summarization.

FileKindSize
SKILL.mdskill md4.9 KB
references/memory-guidelines.mdmarkdown2.0 KB

references/memory-guidelines.md

View on GitHub
# Workflow Memory Guidelines

Use these rules to keep Compozy workflow memory useful across repeated PRD task runs.

## File Roles

### Shared workflow memory: `MEMORY.md`

Use the shared workflow memory for context that should survive across multiple tasks and multiple runs.

Keep:
- current workflow state that affects more than one task
- durable technical or product decisions
- reusable learnings that will matter again
- open risks or handoff notes that change future execution

Avoid:
- step-by-step scratch notes
- large code excerpts
- facts that are already explicit in `_prd.md`, `_techspec.md`, `_tasks.md`, or the repo itself

### Current task memory: `memory/<task filename>`

Use the task memory for context that is specific to the current task.

Keep:
- the current objective snapshot
- important task-local decisions
- local learnings and corrections
- touched files or surfaces worth remembering next run
- ready-for-next-run notes

Avoid:
- cross-task summaries that belong in `MEMORY.md`
- repeated restatements of the task spec
- low-signal command transcripts

## Promotion Rules

Promote an item from task memory into shared workflow memory only when it is:
- durable across runs
- useful to another task
- likely to prevent repeated mistakes or rediscovery

Leave information in task memory when it is:
- operational only for the current task
- temporary
- too detailed for workflow-wide reuse

## Compaction Rules

When compaction is required:
- preserve current state, durable decisions, reusable learnings, open risks, and handoffs
- remove repetition, stale notes, long transcripts, and derivable facts
- rewrite for clarity, not for completeness
- prefer short factual bullets over narrative logs

## Default Section Boundaries

### `MEMORY.md`

- `## Current State`
- `## Shared Decisions`
- `## Shared Learnings`
- `## Open Risks`
- `## Handoffs`

### `memory/<task filename>`

- `## Objective Snapshot`
- `## Important Decisions`
- `## Learnings`
- `## Files / Surfaces`
- `## Errors / Corrections`
- `## Ready for Next Run`
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall