@dujavi/ai-md 0.5.0 → 0.6.0

package/skeleton/README.md

@@ -0,0 +1,3 @@
+# Your private AI config
+
+Edit `shared/` and `agents/<id>/` only. Run `ai-md build` after changes.

package/skeleton/shared/rules/edit-source-not-dist.mdc

@@ -0,0 +1,23 @@
+---
+description: Edit ~/.ai-md shared/ and agents/ only — never live harness dirs or dist/
+alwaysApply: true
+---
+
+# Edit source, not dist or live harness paths
+
+`~/.ai-md` is the source of truth. Live tool dirs (`~/.cursor`, `~/.claude`, `~/.agents`, …) and `~/.ai-md/dist/` are **build outputs**.
+
+## Do
+
+- Edit `~/.ai-md/shared/` for rules/skills that apply to all harnesses.
+- Edit `~/.ai-md/agents/<harness>/` for harness-specific rules/skills.
+- After edits: `ai-md build` (or `ai-md pull` / `install`, which rebuild).
+
+## Do not
+
+- Edit `~/.cursor/{rules,skills}`, `~/.claude/…`, `~/.agents/…`, or any other live harness path.
+- Edit `~/.ai-md/dist/` directly.
+
+## If you already edited a live path
+
+Stop. Run `ai-md rescue --agents <harness>` to promote dirty files into `agents/<harness>/`, then review and `ai-md build`. Do not keep iterating under dist or live dirs.

package/skeleton/shared/rules/personal-config.mdc

@@ -0,0 +1,49 @@
+---
+description: Sync global personal skills and rules via ~/.ai-md and the ai-md CLI (build → dist → link)
+alwaysApply: true
+---
+
+# Personal skills and rules — ai-md
+
+**`~/.ai-md`** is the private source of truth. Use **`ai-md`** (`@dujavi/ai-md`) — not Cursor Sync / Gist.
+
+## Layout
+
+| Path | Role |
+|------|------|
+| `shared/rules`, `shared/skills` | System base for all harnesses |
+| `agents/<id>/` | Harness-specific overlays |
+| `dist/<id>/` | Build output (gitignored) — do not edit |
+| `templates/<type>/` | Project-type starters |
+| `projects/<name>/` | Per-app overlays |
+| `scripts/` | Private machine scripts |
+
+See also `edit-source-not-dist.mdc` and skill `ai-md-config`.
+
+## Sync
+
+```bash
+ai-md pull
+# edit shared/ or agents/<id>/
+ai-md build
+ai-md push -m "why"
+```
+
+`install` / `pull` / `doctor --fix` rebuild and link **only for installed AIs** (detect `~/.cursor`, `claude` on PATH, etc.). Use `--force-link` to override.
+
+## Where to edit
+
+| What | Edit here |
+|------|-----------|
+| Cross-harness rules/skills | `~/.ai-md/shared/` |
+| Cursor-only (e.g. Grok CLI policy) | `~/.ai-md/agents/cursor/` |
+| Project starters | `~/.ai-md/templates/<type>/` |
+| App overlays | `~/.ai-md/projects/<repo>/` |
+
+Never edit `~/.cursor/skills-cursor/`, live harness dirs, or `dist/`.
+
+## Agent behavior
+
+- Global changes → `shared/` or `agents/<id>/`; remind `ai-md build` then `push`.
+- Symlink / dist issues → `ai-md doctor --fix` or `ai-md rescue`.
+- New harness → `ai-md harness set …` then content under `agents/<id>/`.

package/skeleton/shared/skills/ai-md-config/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: ai-md-config
+description: >-
+  Manage personal AI config in ~/.ai-md: shared vs agents layers, build/dist,
+  harness registration, rescue dirty dist. Use when adding rules/skills, fixing
+  links, or supporting a new AI tool.
+---
+
+# ai-md config playbook
+
+## Layout
+
+| Path | Role |
+|------|------|
+| `shared/rules`, `shared/skills` | All harnesses |
+| `agents/<id>/rules`, `agents/<id>/skills` | One harness (overlay wins on name conflict) |
+| `dist/<id>/` | Generated — never edit |
+| `projects/<name>/` | Per-repo overlays (`.cursor` → here) |
+
+## Commands
+
+```bash
+ai-md pull / push -m "why"
+ai-md build [--agents cursor,claude] [--force]
+ai-md rescue --agents cursor
+ai-md harness list | show <id>
+ai-md harness set <id> --skills ~/path [--rules ~/path] [--format mdc|md|skills-only]
+ai-md harness enable|disable <id>
+ai-md init | seed-skeleton
+ai-md doctor --fix
+```
+
+## Add a rule or skill
+
+1. Choose layer: `shared/` (all tools) vs `agents/<id>/` (one tool).
+2. Write the file under that path (never under `dist/` or `~/.cursor/…`).
+3. `ai-md build`
+4. `ai-md push -m "…"` when ready.
+
+## New harness
+
+```bash
+ai-md harness set my-tool --skills ~/.my-tool/skills --rules ~/.my-tool/rules --format md
+# put tool-specific content in agents/my-tool/
+ai-md build --agents my-tool
+```
+
+## Unique vs shared `.agents`
+
+- Unique live roots: `cursor`, `claude`, `gemini`, `opencode`, `copilot`
+- Shared `~/.agents/skills`: `agents` (canonical writer); `codex` is an alias (no second emit)

package/skeleton/templates/base/rules/project-context.mdc

@@ -0,0 +1,8 @@
+---
+description: Project-specific context — customize after init-project
+alwaysApply: true
+---
+
+# Project context
+
+Replace this stub with stack, phase gates, and doc index for this app.