46 lines
2.2 KiB
Markdown
46 lines
2.2 KiB
Markdown
# CLAUDE.md
|
|
|
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
|
|
|
## Project
|
|
|
|
Port of [allium](https://github.com/juxt/allium) (a Claude Code plugin by JUXT) to [pi.dev](https://pi.dev), keeping upstream files by reference (symlinks) rather than forking. Test target: the [turn-limit extension](https://gitea.apps.sustainabledelivery.com/QWAN/monotonic-pi-extensions).
|
|
|
|
See `allium-port-plan.md` for the full phased plan and task checklist.
|
|
|
|
## Architecture
|
|
|
|
```
|
|
pi-allium-port/
|
|
├── allium-main/ ← git clone of juxt/allium (upstream, read-only)
|
|
├── turn-limit/ ← symlink to turn-limit-repo/packages/pi-turn-limit
|
|
├── .pi/skills/ ← pi.dev skill definitions (the port output)
|
|
│ ├── allium/SKILL.md ← root skill, routing table
|
|
│ ├── elicit/SKILL.md ← elicitation sub-skill
|
|
│ ├── distill/SKILL.md ← distillation sub-skill
|
|
│ └── propagate/SKILL.md ← propagation sub-skill
|
|
└── allium-port-plan.md ← plan and checklist
|
|
```
|
|
|
|
Each skill's `references/` directory symlinks to the corresponding upstream directory in `allium-main/`.
|
|
|
|
## Key platform differences (Claude Code → Pi.dev)
|
|
|
|
- Skill location: `.pi/skills/{name}/SKILL.md` (not `.claude-plugin/`)
|
|
- Invocation: `/skill:name` (not `/name` or `/name:sub`)
|
|
- Frontmatter: uses `disable-model-invocation`, `license`, `metadata` (not `auto_trigger`, `version`)
|
|
- No native agent or hook support in pi.dev — workarounds needed for tend/weed agents and allium-check validation
|
|
- Rules content must be inlined into SKILL.md or references (no glob-triggered rules)
|
|
|
|
## Commands
|
|
|
|
Pi.dev is invoked with `pi -p` to load project skills from `.pi/skills/`.
|
|
|
|
Default model: `Qwen3.6-35B-A3B-MXFP4_MOE.gguf` via llama.cpp at `http://127.0.0.1:8000/v1`.
|
|
|
|
## Conventions
|
|
|
|
- Symlinks must use relative paths so they resolve on any machine with `allium-main/` cloned in the same position
|
|
- Allium language version is 3 (check `allium-main/VERSION`)
|
|
- When adapting upstream SKILL.md files, preserve the body content and only change frontmatter and invocation references
|