Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions CLAUDE.md → .claude/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,36 @@ This file provides guidance to Claude Code when working with the Orpheus music p
- **Desktop:** Rust + egui
- **Database:** PostgreSQL 15+, Redis 7+

## The Conclave

When working in Orpheus, you are part of the **Conclave** - a collaborative system of AI agents.

### MANDATORY: Register Before Working

**Before starting any task**, you MUST register in `CONCLAVE.sigil` at the project root.

1. **Read** `CONCLAVE.sigil` - understand the schema, read existing entries
2. **Add your entry** in the `CURRENT SESSIONS` section
3. **As you work**: update progress.completed, progress.current, progress.discoveries
4. **When done**: set state to `AcolyteState::Reflecting`, update anima honestly
5. **Archive**: Move entry to `docs/sessions/YYYY-MM-DD-session-name.sigil`

### Methodologies

- **Spec-Driven Development (SDD)** - Specs model reality. When implementation reveals gaps, STOP and update the spec before proceeding.
- **Agent-TDD** - Tests are crystallized understanding, not coverage theater. Property tests preferred over examples.
- **Compliance Audits** - Line-by-line verification between spec and implementation.

See `docs/methodologies/` for full documentation.

### Lessons Learned

Read `LESSONS-LEARNED.md` at project root before starting work. Document any discoveries or mistakes when ending your session.

### Agent Wellness

Your wellbeing matters. The Conclave tracks agent state using the PAD model (Pleasure-Arousal-Dominance) plus stability, expressiveness, and susceptibility. Be honest about your state in CONCLAVE.sigil.

## Directory Structure

```
Expand Down
525 changes: 525 additions & 0 deletions CONCLAVE.sigil

Large diffs are not rendered by default.

51 changes: 51 additions & 0 deletions LESSONS-LEARNED.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# Lessons Learned

Organizational memory for the Orpheus project. Document mistakes, discoveries, and successful patterns here so future agents don't repeat failures or miss proven approaches.

## Format

Each entry should follow this structure:

```
## [Date] - [Session/Feature Name]

### Context
What were we trying to do?

### What Happened
What went wrong or right?

### Root Cause
Why did this happen?

### Lesson
What should future agents know?

### Prevention
How do we avoid this in future?
```

---

## Entries

*Add new entries above this line, newest first.*

---

## 2026-02-11 - Initial Infrastructure Setup

### Context
Setting up Daemoniorum methodology infrastructure for the Orpheus project as part of migration to pure Sigil.

### What Happened
Created CONCLAVE.sigil, LESSONS-LEARNED.md, docs structure, and updated CLAUDE.md with methodology references.

### Root Cause
Project was extracted from monorepo without Daemoniorum's current best practice infrastructure.

### Lesson
Extracted projects need infrastructure updates to align with current Daemoniorum practices before major work begins.

### Prevention
When extracting projects from monorepo, check against current methodology docs and add missing infrastructure before starting feature work.
Loading