From 2c61b77928410365289a107c8e486500dd1ac3d5 Mon Sep 17 00:00:00 2001 From: Developer Date: Sun, 15 Feb 2026 08:43:10 +0000 Subject: [PATCH 1/2] release: bump version to 0.4.6 and update README for /init skill - Bump package version from 0.4.5 to 0.4.6 - Update README getting started section to document the /init command for generating CLAUDE.md and AGENTS.md - Add /init to the commands table - Update troubleshooting section to reflect that atomic init no longer creates CLAUDE.md/AGENTS.md --- README.md | 23 +++++++++++++++-------- package.json | 2 +- 2 files changed, 16 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 5081da8..390bca3 100644 --- a/README.md +++ b/README.md @@ -174,12 +174,18 @@ atomic init Select your agent. The CLI configures your project automatically. -Then start a chat session: +Then start a chat session and run `/init` to generate `CLAUDE.md` and `AGENTS.md`: ```bash atomic chat -a claude ``` +``` +/init +``` + +The `/init` command explores your codebase using sub-agents and generates populated `CLAUDE.md` and `AGENTS.md` files tailored to your project. These files give coding agents the context they need to work effectively in your repository. + ### Source Control Selection During `atomic init`, you'll be prompted to select your source control system: @@ -335,12 +341,13 @@ Follow the debugging report above to resolve the issue. User-invocable slash commands that orchestrate workflows. -| Command | Arguments | Description | -| -------------------- | ----------------------------------------- | -------------------------------------- | -| `/research-codebase` | `[question]` | Analyze codebase and document findings | -| `/create-spec` | `[research-path]` | Generate technical specification | -| `/explain-code` | `[path]` | Explain code section in detail | -| `/ralph` | `"" [--resume UUID [""]]` | Run autonomous implementation workflow | +| Command | Arguments | Description | +| -------------------- | ----------------------------------------- | -------------------------------------------------- | +| `/init` | | Generate `CLAUDE.md` and `AGENTS.md` by exploring the codebase | +| `/research-codebase` | `[question]` | Analyze codebase and document findings | +| `/create-spec` | `[research-path]` | Generate technical specification | +| `/explain-code` | `[path]` | Explain code section in detail | +| `/ralph` | `"" [--resume UUID [""]]` | Run autonomous implementation workflow | ### Agents @@ -685,7 +692,7 @@ git config --global user.email "you@example.com" **Windows Command Resolution:** If agents fail to spawn on Windows, ensure the agent CLI is in your PATH. Atomic uses `Bun.which()` to resolve command paths, which handles Windows `.cmd`, `.exe`, and `.bat` extensions automatically. -**File Preservation:** When re-running `atomic init`, your custom `CLAUDE.md` and `AGENTS.md` files are preserved by default. Use `--force` to overwrite all files including `CLAUDE.md`/`AGENTS.md`. +**Generating CLAUDE.md/AGENTS.md:** `atomic init` does not create `CLAUDE.md` or `AGENTS.md`. Run `/init` inside a chat session to generate these files. The command explores your codebase and produces project-specific documentation for coding agents. **Ralph Continues After Stopping Session:** If you stop a Ralph session (e.g., Ctrl+C or esc) and open a new session, Ralph may automatically resume. This is expected behavior—Ralph is designed to run autonomously until an exit condition is met (completion promise / max iterations / all features passing) or it's explicitly cancelled. You can still interrupt and give it instructions during execution. diff --git a/package.json b/package.json index d4c8e10..08fdf76 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@bastani/atomic", - "version": "0.4.5", + "version": "0.4.6", "description": "Configuration management CLI for coding agents", "type": "module", "license": "MIT", From 5fd6bf6b5a36f9285d450c7bbac1c776716f0b81 Mon Sep 17 00:00:00 2001 From: Developer Date: Sun, 15 Feb 2026 08:48:34 +0000 Subject: [PATCH 2/2] fix(ci): remove CLAUDE.md and AGENTS.md from publish workflow These files were removed from the repo in 88f0415 but the publish workflow still tried to copy them into the config archive, causing the release CI to fail. --- .github/workflows/publish.yml | 2 -- 1 file changed, 2 deletions(-) diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml index 2c47a37..a6f91be 100644 --- a/.github/workflows/publish.yml +++ b/.github/workflows/publish.yml @@ -84,8 +84,6 @@ jobs: cp -r .opencode config-staging/ mkdir -p config-staging/.github cp -r .github/skills config-staging/.github/ - cp CLAUDE.md config-staging/ - cp AGENTS.md config-staging/ # Remove node_modules from .opencode if present rm -rf config-staging/.opencode/node_modules