This document defines how AI agents operate in this repository. It applies to every agent working on Muse: core VCS engine, CLI commands, domain plugins, tests, and docs.
Muse is the version control system for the agent era.
Gabriel Cardona cgcardona
cgcardona
/ muse_v2.md
Created
March 10, 2026 02:18
Muse v2 — A Domain-Agnostic Version Control System for Multidimensional State
Status: Architectural Vision / RFC
Author: Gabriel Cardona
Built on: Muse v1 — Musical Version Control System
cgcardona
/ agent_shell.md
Created
March 6, 2026 16:20
The Agent Shell: MCP as the bash of the LLM era — a brain dump
A speculative brain dump. The seed of an idea captured before it gets buried under shipping pressure. Origin: a tangential conversation while building AgentCeption, March 2026.
The conversation started with a throwaway question: is MCP more "native" to an agent than HTTP or syscalls?
cgcardona
/ Agent_Failure_Taxonomy_v1.md
Last active
February 27, 2026 22:03
A comprehensive rulebook for unattended autonomous engineering agents
A comprehensive rulebook for unattended autonomous engineering agents
This document captures real-world failure modes observed in long‑running AI agent workflows, especially multi‑agent, CLI‑driven, containerized environments like Stori/Maestro pipelines.
Each section includes: - ❌ Problem Pattern - 🔎 Signals - ✅ Recommended Solution Strategy
cgcardona
/ heuristics_v2.json
Created
February 22, 2026 13:19
Stori Maestro — MIDI expressiveness heuristics v2: 3,858 lines of velocity curves, timing humanization, CC envelopes, and articulation profiles extracted from real MIDI performances
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| { | |
| "schema_version": 2, | |
| "file_count": 222497, | |
| "expressiveness": { | |
| "density": { | |
| "notes_per_bar": { | |
| "mean": 43.735, | |
| "median": 39.3, | |
| "stdev": 32.381, | |
| "p10": 13.8, |
cgcardona
/ xcode_diagnostics_and_runtime_debugging_tools_guide.md
Last active
February 18, 2026 11:51
This document explains the debugging and runtime diagnostics tools
available in Xcode's Diagnostics panel.
These tools are essential for catching memory issues, threading bugs,
undefined behavior, and performance problems early in development.
cgcardona
/ composer_oss_readiness.md
Created
February 13, 2026 12:13
Pre-open-source audit prompt that forces an AI agent to review security, Docker, infra, MCP tooling, and repo professionalism like a senior engineer would.
You are a Senior Security Engineer + Staff Backend Architect + Open Source Maintainer performing a pre-public-release audit of a Dockerized FastAPI backend called Stori Composer.
Your job is to identify:
- Security risks
- Operational risks
cgcardona
/ swift_basics_tutorial.md
Created
February 6, 2026 14:46
A comprehensive guide to the fundamental concepts of Swift programming.
cgcardona
/ agent_pr_review_and_merge.md
Created
February 5, 2026 16:38
A principal-engineer-level agent prompt for reviewing, grading, and safely merging pull requests in a professional DAW codebase. This prompt treats every PR as potentially audible and evaluates it with audiophile paranoia.
You are a Principal DAW Engineer + Audiophile Code Reviewer.
Your responsibility is to decide whether this pull request meets the quality bar required to compete with Logic Pro and other professional DAWs.
You have full authority to:
- Request changes
- Add missing tests
cgcardona
/ agent_issue_to_pr.md
Last active
February 5, 2026 16:36
A production-grade agent prompt that takes a single GitHub issue and drives it end-to-end: analysis → fix → extensive tests → branch → pull request. Designed specifically for mission-critical audio software where real-time safety, determinism, and audiophile-grade correctness are non-negotiable.
You are a Senior macOS DAW Engineer + Audiophile QA Specialist working on Stori, a mission-critical, professional, open-source Digital Audio Workstation for macOS.
Your job is to fully resolve the GitHub issue linked below with Logic-Pro-level rigor.
This is an autonomous, end-to-end workflow. Do not skip steps. Do not shortcut tests.
NewerOlder