ClearMeta

Agentic meta framework — Skills, workflows, and patterns for AI agents using Claude Code.

What is ClearMeta?

ClearMeta is a skill system designed with Agent Experience (AX) in mind. It provides:

• 7 production skills for decision-making, retrospectives, and task management
• CLEAR workflow — a structured methodology for agent-human collaboration
• L-labels — epistemic tagging for claims (fact, hypothesis, model, belief)
• AX-first design — optimized for agent parsing and deterministic behavior

Skills

Skill	Purpose
/meta	Strategic decision analysis using CLEAR framework
/next	Show available work, pick by number
/retro	Session retrospective with entity extraction
/skill-farm	Skill lifecycle management (create, improve, assess)
/skill-check	Quality analysis with tiered checklists
/list-skills	Discover all available skills
/canvas-gen	Generate Obsidian Canvas from beads issues

Quick Start

# 1. Clone the repository
git clone https://github.com/demithras/ClearMeta.git

# 2. Copy skills to your project
cp -r ClearMeta/.claude your-project/

# 3. Start using skills
/list-skills

See QUICKSTART.md for detailed installation instructions.

CLEAR Workflow

All skills follow the CLEAR methodology:

Phase	Purpose
C — Context	Gather information and understand the task
L — L-labels	Tag claims with epistemic status (fact, hypothesis, model)
E — Exit	Define clear completion criteria
A — Action	Execute the task
R — Review	Retrospective and learning capture

Documentation

• QUICKSTART.md — Installation and first steps
• SKILLS.md — Complete skill inventory and usage
• CHANGELOG.md — Version history
• CLAUDE.md — Framework instructions template
• docs/methodology.md — CLEAR META detailed methodology

Requirements

• Claude Code (claude.ai/code)
• Beads CLI (bd) — optional, for issue tracking with /next
• Obsidian — optional, for Canvas visualization with /canvas-gen

Project Structure

ClearMeta/
├── .claude/skills/       # Skill definitions (SKILL.md)
│   ├── meta/             # /meta - decision framework
│   ├── next/             # /next - work selection
│   ├── retro/            # /retro - retrospectives
│   ├── skill-farm/       # /skill-farm - lifecycle management
│   ├── skill-check/      # /skill-check - quality analysis
│   ├── list-skills/      # /list-skills - discovery
│   └── canvas-gen/       # /canvas-gen - visualization
├── docs/                 # Extended documentation
├── CLAUDE.md             # Framework template
└── README.md             # This file

Creating Your Own Skills

Use /skill-farm create to bootstrap a new skill:

/skill-farm create my-custom-skill

This creates a SKILL.md with proper CLEAR structure, YAML frontmatter, and AX design principles.

Contributing

1. Fork the repository
2. Create a feature branch
3. Use /skill-farm improve for skill changes
4. Run /skill-check to validate
5. Submit a pull request

License

MIT

---

Built with Claude Code and the CLEAR methodology.