init-agent-config

Files (1)

• SKILL.md

SKILL.md (first lines)

# /init-agent-config

Compose `agent-harness` into a project — interactive scaffold that asks about project type and selects the right subset.

## Master TOC

- [Pre-flight](#pre-flight)
- [Step 1: Detect the current project state](#step-1-detect-the-current-project-state)
- [Step 2: Ask the user 6 questions](#step-2-ask-the-user-6-questions)
- [Step 3: Resolve consumption mode](#step-3-resolve-consumption-mode)
- [Step 4: Compose the project](#step-4-compose-the-project)
- [Step 5: Post-setup verification](#step-5-post-setup-verification)
- [Step 6: Show summary + next steps](#step-6-show-summary--next-steps)
- [Idempotency](#idempotency)

## Pre-flight

Verify (per `plugin-preflight` rule):

- `agent-harness` is locally cloned at `~/.claude/agent-harness/` OR the user has internet access for raw-URL imports OR the plugin is installed
- The current directory is writable and the user is OK adding `CLAUDE.md` / `.claude/` / etc.

If `agent-harness` is not yet cloned and the user wants the local-clone consumption mode:

```bash
git clone https://github.com/jajupmochi/agent-harness.git ~/.claude/agent-harness
```

Ask the user before running this.

## Step 1: Detect the current project state

```bash
# Check if directory is empty
ls -A | wc -l

# Check if it's a git repo
git rev-parse --is-inside-work-tree 2>/dev/null

# Check for existing CLAUDE.md
ls CLAUDE.md 2>/dev/null

# Detect language / framework hints
ls package.json pyproject.toml Cargo.toml go.mod 2>/dev/null
```

Branches:

- **Empty directory** → fresh scaffold from a `agent-harness` template
- **Existing project, no CLAUDE.md** → add `CLAUDE.md` + `.claude/` on top of existing code
- **Existing project, with CLAUDE.md** → ask the user: merge with existing? back up first? skip CLAUDE.md and only do `.claude/`?

## Step 2: Ask the user 6 questions

Use `AskUserQuestion` to gather:

1. **Project type** (single-select):
   - Python research package
   - Static personal/portfolio site (HTML/CSS/JS)
   - Frontend application (React / Vue / etc.)
   - Other / custom (skip template, just add rules + tooling)

2. **Bilingual policy** (single-select):
   - Bilingual (EN canonical + zh mirror) for top-level docs
   - English only
   - Chinese only
   - Other / let me decide later

3. **Final-output language preference** (single-select):
   - Chinese (中文) — apply `chinese-output` rule
   - English — skip the rule
   - Other / let me decide later

4. **Context tags** (multi-select — only the matching items get installed):
   - `always` (universal rules: pre-edit-confirmation, phased-planning, plugin-preflight)
   - `research-pkg` (Python tooling: uv + ruff + pytest)
   - `ui-project` (JS/UI/animation/build/test/style)
   - `static-site` (HTML/CSS/JS, i18n, Lighthouse via chrome-devtools)
   - `ml-research` (HF Hub, datasets, gpustat, orchestra-ml-skills)
   - `web-perf` (Lighthouse + a11y tooling)
   - `image-or-video-work` (sharp, ffmpeg, etc.)
   - `docs-site` (mkdocs)
   - `electron-or-desktop` (Electron + electron-builder)

5. **Consumption mode** (single-select):
   - Raw URL imports — always live, requires network
   - Local clone (`~/.claude/agent-harness/`) — fast, offline
   - Plugin install (P10+) — most native; only if `/plugin install jajupmochi/agent-harness` was run

6. **Personal-preference rules** (multi-select):
   - `output-brevity` — no end-of-batch recap, no echo, prefer Edit over Write
   - `tool-proactivity` — fire installed tools without asking
   - `no-reread-files` — trust in-session memory of file contents

## Step 3: Resolve consumption mode

Build the `@import` paths based on the user's choice:

- **Raw URL**: `@https://raw.githubusercontent.com/jajupmochi/agent-harness/main/<path>`
- **Local clone**: `@~/.claude/agent-harness/<path>`
- **Plugin**: (no `@import` lines — plugin auto-loads)

## Step 4: Compose the project

Based on choices, do:

### 4.1 Copy the template (if a project type was selected)

```bash
# Python research:
cp -r ~/.claude/agent-harness/templates/research-package-py/. ./

# Static site:
cp -r ~/.claude/agent-harness/templates/personal-cite-static/. ./
```

### 4.2 Substitute placeholders

Ask the user for:

From jajupmochi/agent-harness, MIT.

More from jajupmochi/agent-harness