Skip to content

docs(archdev-skill): onboard with repo map init, never repo init; login without email #29

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
calvin-archastro merged 1 commit into from
Sep 23, 2026
Merged

docs(archdev-skill): onboard with repo map init, never repo init; login without email #29

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions archdev/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion archdev/references/bootstrap.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
15 changes: 10 additions & 5 deletions archdev/references/map.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 <unique-private-repo-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.

Expand Down
Loading