workflow/feynman/README.md

Feynman Configuration

This directory contains Feynman-specific configurations that can be installed alongside the workflow.

What's Included

feynman/
├── README.md           ← This file
├── skills/
│   └── workflow-bootstrap/
│       └── SKILL.md    ← Skill to bootstrap new projects
└── memory-template.md  ← Memory template to load into Feynman

Installation

These are installed automatically by pnpm run setup if Feynman is detected.

Manual Installation

Skill:

mkdir -p ~/.feynman/agent/skills
cp -r feynman/skills/* ~/.feynman/agent/skills/

Memory:

# Copy as memory.md in your project's .feynman directory
cp feynman/memory-template.md /path/to/your/project/.feynman/memory.md

# Or load into Feynman's persistent memory directly

What the Skill Does

The workflow-bootstrap skill allows Feynman to set up the issue-based workflow for any new project:

1. Clone the workflow template from https://git.fbrns.co/shoko/workflow
2. Copy docs, issues structure, and hooks to the current project
3. Run the setup script
4. Summarize what was set up

Trigger phrases:

• "feynman, start a new project"
• "set up the workflow"
• "apply the workflow template"
• "initialize the issue-based workflow"

What the Memory Does

The memory template contains:

• pref.new_project_workflow: Location and structure of the workflow template
• lesson.workflow.new_project_nudge: A nudge rule to remind you to use the workflow

This gives you a two-layer enforcement:

1. Skill (manual trigger): You say "new project" and Feynman sets it up
2. Memory (automatic nudge): If you forget, Feynman reminds you

For Fresh Feynman Installations

If you're running Feynman on a new host:

# 1. Clone the workflow template (it includes feynman configs)
git clone https://git.fbrns.co/shoko/workflow.git my-project
cd my-project

# 2. Run setup (installs pnpm, hooks, and feynman configs)
pnpm run setup

# 3. Load the memory into Feynman
# In Feynman: /memory.md to load the memory template
# Or: copy feynman/memory-template.md to your project's .feynman/memory.md