agent-platform

Personal platform for semi-autonomous software development: infrastructure, agent instructions, shared skills, CI workflows, and the services (code review, Work Graph) that project repos build on.

Coding agents should read AGENTS.md.

New project repos

copier copy --trust gh:janclem/agent-platform <dir>   # new project
copier update --trust                                 # inside a project, pull template changes

The template provides AGENTS.md, the CI and security workflows, the Renovate preset, the agent skills, and a mise.toml that pins the platform tools. Template versions are this repo's vX.Y.Z tags, and Renovate proposes copier updates in projects.

Reusable workflows

Project repos run the platform checks and security scans by calling the reusable workflows:

jobs:
  platform: # required status check: `platform / checks`
    permissions:
      contents: read
    uses: janclem/agent-platform/.github/workflows/checks.yml@<v1 commit SHA> # v1.0.0

Pin the commit, as jactionlint requires; Renovate keeps the pin current.

checks.yml lints workflows and checks Terraform under infra/, the agent skill layout, and the Renovate config. It then runs the project's own mise run ci task if one exists. Each check skips itself when the repo has nothing for it to check. Tools come from the project's mise.toml, so pin jactionlint, shellcheck, and (with infra/) terraform there. Call scans.yml the same way, granting security-events: write, for gitleaks and zizmor.

Shared skills

Agent skills live in .agents/skills/, which Codex reads, with pointer files in .claude/skills/ for Claude Code. This follows the layout of Robbie's hq. Project repos get copies from this repo's Copier template and pick up changes with copier update.

Self-hosted servers

homelab/ declares NixOS hosts as a flake. Adding, installing, and rebuilding a host is covered in docs/runbooks/nixos-hosts.md. Hosts that run coding agents are set up with docs/runbooks/agent-host.md.

Decisions

Why the platform is built this way is recorded in the architecture decision records.

Credits

The architecture follows Robbie Palmer's semi-autonomous software development initiative and his hq monorepo. Files adapted from hq keep their original copyright notices; homelab/ follows the layout of hq's homelab/ flake.

License

GNU Affero General Public License v3.0.