From 25c489693672e5ee17c7efebb4955c4975210a43 Mon Sep 17 00:00:00 2001 From: calvin-archastro Date: Wed, 23 Sep 2026 13:29:57 -0700 Subject: [PATCH] docs(archdev-skill): onboard with repo map init, never repo init; login without email `repo init` is jobs daemon registration (private clone + local daemon); the repo namespace only needs archdev.json, which `repo map init` creates. `auth login` needs no email argument. Co-Authored-By: Claude Opus 5.5 (1M context) --- archdev/SKILL.md | 5 +++-- archdev/references/bootstrap.md | 2 +- archdev/references/map.md | 15 ++++++++++----- 3 files changed, 14 insertions(+), 8 deletions(-) diff --git a/archdev/SKILL.md b/archdev/SKILL.md index 075c961..29eeda2 100644 --- a/archdev/SKILL.md +++ b/archdev/SKILL.md @@ -1,6 +1,6 @@ --- name: archdev -description: Core ArchDev workflow — use for anything involving ArchDev. Covers archdev CLI setup, upgrade, login, and model access; archdev.json configuration and validation (check); repo onboarding and readiness (repo status, repo init); mapping a repo's plans, tasks, agents, and review workflow into the activity taxonomy (repo map); harness monitor hooks (repo hook setup); reporting build events as unstructured notes or schema-validated payloads (archdev log post, log post --event); reading and searching the team room for prior lessons (log messages, log search); publishing team lifecycle posts — start, lesson, abandoned, done, handoff, question (log --kind); and observing agent activity (repo monitor). Load at session start whenever the archdev CLI is installed, the repo contains archdev.json, or the task touches plans, tasks, sessions, commits, PRs, or harness hooks. +description: Core ArchDev workflow — use for anything involving ArchDev. Covers archdev CLI setup, upgrade, login, and model access; archdev.json configuration and validation (check); repo onboarding and readiness (repo status); mapping a repo's plans, tasks, agents, and review workflow into the activity taxonomy (repo map); harness monitor hooks (repo hook setup); reporting build events as unstructured notes or schema-validated payloads (archdev log post, log post --event); reading and searching the team room for prior lessons (log messages, log search); publishing team lifecycle posts — start, lesson, abandoned, done, handoff, question (log --kind); and observing agent activity (repo monitor). Load at session start whenever the archdev CLI is installed, the repo contains archdev.json, or the task touches plans, tasks, sessions, commits, PRs, or harness hooks. --- # ArchDev @@ -57,7 +57,8 @@ current, user logged in (`auth status`), model access configured ## 2. Map Read [map.md](references/map.md). Goal: repo opted in via `archdev.json` -(`repo init` when missing; personal overrides stay in gitignored +(`repo map init` creates it when missing — never `repo init`, which is +jobs daemon registration; personal overrides stay in gitignored `archdev.local.json`), plus the `activity` taxonomy describing how this repo plans, codes, reviews, and takes instruction. End by installing the monitor hooks (`repo hook setup`) so session coverage starts diff --git a/archdev/references/bootstrap.md b/archdev/references/bootstrap.md index a8d57da..3bf808c 100644 --- a/archdev/references/bootstrap.md +++ b/archdev/references/bootstrap.md @@ -8,7 +8,7 @@ and how to clear it. ## 1. Version and login 1. `"$archdev" --version` (need 0.45.3+), then `"$archdev" auth status`. -2. If unauthenticated: `"$archdev" auth login [email]` (browser, +2. If unauthenticated: `"$archdev" auth login` (browser, copy/paste, or personal access token). Keep a persistent interactive process running while the human signs in; do not proceed headless. 3. `auth logout` removes credentials — never run it as a fix for anything. diff --git a/archdev/references/map.md b/archdev/references/map.md index 49c1285..4814b56 100644 --- a/archdev/references/map.md +++ b/archdev/references/map.md @@ -5,11 +5,16 @@ under the `activity` key, then install the monitor hooks. ## 1. Init -1. If `archdev.json` exists in the repo root, keep it. -2. If absent: `"$archdev" repo init [--name ]` - (same as `init` / `jobs repo enable`). This creates `archdev.json` - with `local.project_id` / `local.repo_name`. -3. Personal/model overrides (`modelAliases`, `factory.model`, provider +1. If `archdev.json` exists in the repo root, keep it. It opts the repo + in; the local daemon is not involved. +2. If absent: `"$archdev" repo map init` (§2) creates `archdev.json` + along with the activity skeleton. A CLI that refuses here predates + this; re-run the bootstrap script to upgrade. +3. Do not run `repo init` (`jobs repo enable`) for onboarding. It + clones a private repository and registers it with the local daemon, + which only jobs, Factory, and PR watching need. `repo status` does + not check it. +4. Personal/model overrides (`modelAliases`, `factory.model`, provider accounts) belong in gitignored `archdev.local.json`, never in the checked-in file. Re-run `"$archdev" check` after editing.