alignfirst
Software engineering tools built for 2026.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/paleo--alignfirst)HTML
<a href="/listings/paleo--alignfirst"><img src="/api/listings/paleo--alignfirst/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Our `alignfirst-setup-guide` skill can help to install these tools. Temporarily install the skill (globally or locally):
npx skills add https://github.com/paleo/alignfirst --global --skill alignfirst-setup-guide
Then, in your project, ask your agent:
Use your alignfirst-setup-guide skill. What can I set up in this project?
At the end, feel free to uninstall the skill. It won't be used by your project anymore.
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 68 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # AlignFirst monorepo
- Companion products for AI-assisted software work. They can be used independently.
- Home page: **[alignfirst.paroi.tech](https://alignfirst.paroi.tech/)**.
- ## `alignfirst` CLI
- The `alignfirst` CLI provides the AlignFirst workflows. See [the CLI README](packages/alignfirst/README.md) for installation and usage.
- ### Agent skills
- Nine Agent Skill stubs expose the CLI through commands such as `/alspec` in Claude Code and `$alspec` in Codex. See [the Agent skills section](packages/alignfirst/README.md#agent-skills).
- ## Docmap - Agent-discoverable documentation
- `@alignfirst/docmap` is a lightweight table of contents that lets agents navigate documentation files. This way we have one set of docs, shared by humans and AI agents. See [packages/docmap/README.md](packages/docmap/README.md).
- ## Workspaces - Local environments with worktrees
- `alignfirst workspace` and `alignfirst dev`, backed by `@alignfirst/workspace`, prepare and run language-neutral Git-worktree environments without consumer JavaScript wrappers. See [packages/workspace/README.md](packages/workspace/README.md).
- ## AlignDev - Autonomous software development
- `aligndev` turns a Claude Code or Codex session, or an OpenClaw bot, into an **assistant**: you talk to it, and it delegates the coding to an AI coding agent through the AlignFirst protocols. See [packages/aligndev/README.md](packages/aligndev/README.md).
- ### AlignDev for OpenClaw
- AlignDev for OpenClaw deploys the assistant as an OpenClaw bot. One deployment is a dedicated service account running it under its own name and channel identity. See [Start as an OpenClaw Bot](packages/aligndev/README.md#start-as-an-openclaw-bot).
- [`@alignfirst/service-openclaw-plugin`](packages/service-openclaw-plugin/README.md) supplies an assistant's OpenClaw capabilities under plugin ID `alignfirst-service`. Its first capability, thread handoff, durably activates the ordinary thread session after confirmed native starter delivery.
- ## OpenClaw Test toolkit
- `@alignfirst/openclaw-test` and three companion channel packages are a Dockerised regression-test harness that drives OpenClaw through synthetic Discord and Slack channels. See [packages/openclaw-test/README.md](packages/openclaw-test/README.md).
- ---
- ## Setup with your agent
- Our `alignfirst-setup-guide` skill can help to install these tools. Temporarily install the skill globally:
- ```bash
- npx skills add https://github.com/paleo/alignfirst --global --skill alignfirst-setup-guide
- ```
- Then, in your project, ask your agent:
- ```text
- Use your alignfirst-setup-guide skill. What can I set up in this project?
- ```
- At the end, feel free to uninstall the skill. It won't be used by your project anymore.
- ---
- ## Contribute
- After a fresh clone:
- ```sh
- npm install
- npm run build
- # Prepare ignored effective .plans separately, then:
- npm run workspace -- setup
- ```
- Tracked settings, nested conventions, the assistant-instructions reference and the workspace recipe live in one `alignfirst.json`. A fresh linked worktree can run `npx -y alignfirst workspace setup` without local dependencies or build output; see [`DEVELOPERS.md`](DEVELOPERS.md) for preparation and cleanup. Existing old runtime state needs the [coordinated upgrade](docs/upgrading-multi-stack-workspaces.md) before lifecycle use.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.