agentic-loadout 0.1.0__tar.gz

agentic_loadout-0.1.0/.gitattributes

@@ -0,0 +1,2 @@
+* text=auto
+src/agentic_loadout/assets/** text eol=lf

agentic_loadout-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,40 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: tests (${{ matrix.os }}, py${{ matrix.python }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python: ["3.11", "3.13"]   # the lowest supported and the newest
+    env:
+      UV_PYTHON: ${{ matrix.python }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+      # Add `uv run ruff check .` / `uv run mypy src tests` steps (here and in release.yml) if the project uses them.
+      - run: uv run pytest -q
+
+  install-smoke:
+    name: clean install of the built wheel
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+      - run: uv build
+      - name: Install the wheel into an empty venv and run the CLI away from the checkout
+        run: |
+          uv venv --python 3.12 "$RUNNER_TEMP/venv"
+          uv pip install --python "$RUNNER_TEMP/venv/bin/python" dist/*.whl
+          cd "$RUNNER_TEMP"
+          "$RUNNER_TEMP/venv/bin/agentic-loadout" --help
+          "$RUNNER_TEMP/venv/bin/python" -c "import importlib.resources as r; assert r.files('agentic_loadout').joinpath('assets/agents/coder.md').is_file()"

agentic_loadout-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,40 @@
+name: Release
+# Manual on purpose: run it (Actions -> Release -> Run workflow, with the tag, e.g. v1.0.0) after CI is
+# green on main, the tag is pushed, the PyPI trusted publisher exists for this repo and the GitHub
+# environment "pypi" is set up.
+on:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: Release tag to publish, e.g. v1.0.0
+        required: true
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: write   # to create the GitHub release
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          ref: ${{ inputs.tag }}
+      - uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+      - name: The tag must match the package version
+        env:
+          TAG: ${{ inputs.tag }}
+        run: |
+          v=$(python3 -c "import tomllib;print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          test "v$v" = "$TAG" || { echo "tag $TAG != version $v"; exit 1; }
+      - run: uv run pytest -q
+      - run: uv build
+      - run: uvx twine check --strict dist/*
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1
+      - name: Create the GitHub release with the CHANGELOG notes and the built files
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ inputs.tag }}
+        run: |
+          python3 scripts/release_notes.py "$TAG" > release-notes.md
+          gh release create "$TAG" dist/* --title "$TAG" --notes-file release-notes.md --verify-tag

agentic_loadout-0.1.0/.gitignore

@@ -0,0 +1,5 @@
+__pycache__/
+.venv/
+dist/
+*.egg-info/
+.pytest_cache/

agentic_loadout-0.1.0/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## [0.1.0] - 2026-10-29
+
+First release.
+
+- One command that installs a coding-agent setup into a project, for Claude Code, Cursor and Codex, writing only
+  inside the project.
+- Project memory through agemem (0.1.1+), which also turns off Claude Code's built-in auto-memory.
+- The `sdd-feature` spec-driven development skill and the `worktree` skill, installed with `npx skills` at pinned
+  commits.
+- Subagents (`architect`, `coder`, `code-grader`, `utility`) and the workflow rules.
+- Language coders (`coder-python`, `coder-typescript`, `coder-swift`) with their navigation MCPs, detected and
+  confirmed, with a `coders` command.
+- `--personal-settings` and `--git-exclude` keep the changes out of git; `--dry-run`, `--without`, `--yes` and
+  `--no-input` for control and automation.

agentic_loadout-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Illescas Romero
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agentic_loadout-0.1.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.5
+Name: agentic-loadout
+Version: 0.1.0
+Summary: One command that gives a project an agent setup: memory (agemem), the SDD skill, subagents and language coders with code-navigation MCPs. Project-scoped, for Claude Code, Cursor and Codex.
+Project-URL: Repository, https://github.com/illescasDaniel/agentic-loadout
+Project-URL: Issues, https://github.com/illescasDaniel/agentic-loadout/issues
+Project-URL: Changelog, https://github.com/illescasDaniel/agentic-loadout/blob/main/CHANGELOG.md
+Author-email: Daniel Illescas Romero <illescas.daniel@protonmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agemem,claude-code,codex,cursor,mcp,memory,sdd,subagents
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: pyyaml<7,>=6.0.3
+Description-Content-Type: text/markdown
+
+# agentic-loadout
+
+[![PyPI](https://img.shields.io/pypi/v/agentic-loadout)](https://pypi.org/project/agentic-loadout/)
+
+One command that gives a project a coding-agent setup, for Claude Code, Cursor and Codex.
+
+- **Memory:** [agemem](https://github.com/illescasDaniel/agemem) keeps current state, decisions and durable notes in
+  `memory/`, so a new session picks up where the last one stopped. For Claude Code, agemem (0.1.1+) also
+  disables Claude's built-in auto-memory for the project, to avoid double memory.
+- **Spec-driven development:** the `sdd-feature` skill takes a feature through design, spec, tests, implementation and
+  an independent grade, with an approval gate between phases.
+- **Subagents:** an orchestrator delegates to `architect` (design), `coder` (implementation), `code-grader` (review)
+  and `utility` (commits, checks), following one shared workflow.
+- **Language coders:** `coder-python`, `coder-typescript` and `coder-swift` come with code-navigation MCPs, so they
+  rename and refactor through the compiler or type checker instead of `grep` and `sed`.
+
+Each piece is handed to the tool that already installs it; agentic-loadout only writes what no tool covers.
+
+Needs `uv` (agemem, Python coder) and Node.js 20+ (skill, TypeScript coder).
+
+`--python 3.12` makes `uvx` use a tested Python instead of whichever is newest on your machine. For a reproducible run,
+also pin the version: `uvx --python 3.12 agentic-loadout@0.1.0 .`
+
+## Use
+
+```bash
+uvx --python 3.12 agentic-loadout .                  # detects your clients and languages, asks before installing
+uvx --python 3.12 agentic-loadout . --dry-run        # prints the commands and the files they write; changes nothing
+uvx --python 3.12 agentic-loadout . --personal-settings --yes
+```
+
+<details>
+<summary>Or let your coding agent do it: a prompt to paste into Claude Code, Cursor or Codex, opened in the project</summary>
+
+> Install agentic-loadout in this project. It is a PyPI package (`agentic-loadout`), run with
+> `uvx --python 3.12 agentic-loadout` (it needs `uv` and Node.js 20+; tell me if either is missing). First read the
+> project's existing instructions, agents, skills, MCP config and settings (`AGENTS.md`, `CLAUDE.md`, `.claude/`,
+> `.cursor/`, `.codex/`, `.agents/`, `.mcp.json`). Run `uvx --python 3.12 agentic-loadout . --dry-run` and review the
+> plan with me: which clients to target (`--tools claude,cursor,codex`), which parts to leave out (`--without
+> sdd|agemem|agents|coders|worktree`), which language coders it detected (`--with python,swift,typescript`), the memory
+> provider (`--memory-model jev|qsiv`), and anything that contradicts the project's current rules or setup. Never
+> overwrite or move my existing rules; resolve conflicts with me, and ask before using `--force`. Ask me before it runs
+> Homebrew for the Swift coder. Then run the real install, review the resulting diff, warnings and next steps, adapt
+> the generated sections (quality-gate command, layering, conventions, how to set up the environment in a new
+> worktree) to this project, and tell me what is left for me to do, such as restarting the client and approving the new
+> MCP servers and hooks. If memory uses the jev provider, tell me where the API key goes; never ask me to paste it into
+> the chat. Also ask me whether the changes should be added to git and committed, or kept as my personal settings; if
+> personal, run the install with `--personal-settings`, then walk me through every file that could still be changed or
+> was changed (e.g. `AGENTS.md`, `.claude/`, `CLAUDE.local.md`, `.mcp.json`) so I can choose what to do with each:
+> ignore it (`.gitignore`), exclude it locally (`.git/info/exclude`, or `--git-exclude`), hide just those edits with
+> `git update-index --skip-worktree`, or commit it anyway. Note that agemem writes this machine's absolute project
+> path into its MCP and hook entries, so those files shouldn't be committed as they are.
+
+</details>
+
+**Everything stays inside the project.** Nothing is written to `~/.claude`, `~/.codex`, `~/.cursor` or any user-wide
+config. The two exceptions: agemem keeps its own private `~/.config/agemem/config.yaml` for the API key, and the Swift
+coder's binary is installed with Homebrew, only after you say yes (even with `--yes`; `--allow-brew` skips the question).
+
+Rules go to `AGENTS.md`, or to `CLAUDE.md` if the project already has one that isn't just an `@AGENTS.md` import. Each
+section sits between `<!-- agentic-loadout:begin NAME -->` markers, so re-running updates it in place.
+
+## What gets installed
+
+| Piece | Installed by |
+|---|---|
+| Project memory (`memory/`, notes, MCP, hooks) | [agemem](https://github.com/illescasDaniel/agemem) `project init` |
+| Spec-driven development skill | `npx skills add illescasDaniel/sdd-feature-skill` |
+| Worktree skill (`/worktree create\|save\|apply\|delete`) | `npx skills add illescasDaniel/worktree-skill` |
+| Subagents (`architect`, `coder`, `code-grader`, `utility`) and the workflow rules | agentic-loadout |
+| Language coders (`coder-python`, `coder-typescript`, `coder-swift`) with their navigation MCPs | agentic-loadout |
+
+### Worktrees
+
+The `worktree` skill runs a task in an isolated git worktree. `/worktree create` branches from the current branch and
+sets up the environment, `save` commits, `apply` merges into the branch the worktree came from, and `delete` removes
+it. agentic-loadout adds a short rule to your instructions: when your checkout has uncommitted changes the agent didn't
+make, it asks once whether to use a worktree, and after the task it offers `save`, `apply` and `delete`. It never
+merges, pushes or deletes without your yes. Leave it out with `--without worktree`.
+
+### Language coders
+
+A coder is one unit: the `coder-<lang>` subagent, the language's navigation MCP and a routing rule. They are always
+installed together, because without the subagent's instructions the agent doesn't use the MCP.
+
+```bash
+uvx --python 3.12 agentic-loadout coders                    # detect languages, confirm, install
+uvx --python 3.12 agentic-loadout coders python typescript  # or name them (python, typescript, swift, all)
+uvx --python 3.12 agentic-loadout coders --list             # catalogue, what is detected, what is installed
+```
+
+| Language | MCP | Detected by |
+|---|---|---|
+| python | codenav | `pyproject.toml`, `setup.py`, `requirements*.txt`, `Pipfile`, `uv.lock` |
+| typescript | webnav | `package.json`, `tsconfig.json`, `jsconfig.json`, `deno.json` |
+| swift | codenav-swift (needs the Homebrew binary, macOS) | `Package.swift`, `*.xcodeproj`, `*.xcworkspace`, `Podfile` |
+
+### Keeping it out of git
+
+`--personal-settings` writes rules to `CLAUDE.local.md` (Claude Code only; it starts with `@AGENTS.md` if you have one),
+Claude settings to `.claude/settings.local.json`, and adds every file the run created to `.git/info/exclude`. A file
+that already existed and was changed (for example a committed `.mcp.json`) can't be hidden by git, so the final message
+lists it with your options. With Cursor or Codex selected the rules go to `AGENTS.md` and you are told.
+`--git-exclude` does the exclusion without the personal files.
+
+### Flags
+
+`--tools claude,cursor,codex` · `--with python,swift,typescript|all` · `--without sdd|agemem|agents|coders|worktree` ·
+`--memory-model jev|qsiv` · `--no-hooks` · `--model ALIAS` · `--claude-compat` · `--dry-run` · `--no-input` · `--yes` ·
+`--allow-brew` · `--force`. With `--no-input` and no `--yes`/`--with`, no language coder is installed and the command to
+run is printed.
+
+The Jev key is never asked for here. Set `AGEMEM_JEV_API_KEY` or edit `~/.config/agemem/config.yaml`.
+
+## Development
+
+```bash
+uv run pytest
+```
+
+The design and the decisions behind it are in [PLAN.md](PLAN.md). The real Homebrew path can only be checked on macOS.