paleo

via GitHub · Posted Jul 14, 2026 · 1 min read

Alignfirst

paleo/alignfirst

Claude Skill

Companion products for AI-assisted software work.

86Stars

7Forks

5Open issues

TypeScript CC0-1.0 @paleo/[email protected] Updated 2 hours ago

#agent-skills #agentic-coding #agentic-engineering

View on GitHub

At a glance

Node.js Actively maintained Commercial OK

Covers DevOps & Infrastructure 4 Productivity 1 Writing & Editing 1

0 comments

README

AlignFirst monorepo

Companion products for AI-assisted software work. They can be used independently.

AlignFirst skills

Collaborative spec/plan/AAD/merge/review protocols. See alignfirst-skills.md.

Team plans repository

@paleo/plans-share shares the .plans directory of the AlignFirst skills among a team, through a dedicated plans repository. See packages/plans-share/README.md.

Docmap - Agent-discoverable documentation

@paleo/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.

Workspaces - Local environments with worktrees

@paleo/workspace runs multiple dev environments side by side using git worktrees. See packages/workspace/README.md.

OpenClaw Test toolkit

@paleo/openclaw-test and three companion channel packages: they are a Dockerised regression-test harness that drives OpenClaw through synthetic Discord and Slack channels. See packages/openclaw-test/README.md.

AlignFirst Developer

AlignFirst Developer is an AI teammate for software work, currently packaged on OpenClaw. See alignfirst-developer.md.

Setup with your agent

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 --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.

Contribute

After a fresh clone:

npm install
npm run build --workspace @paleo/workspace
npm run workspace -- setup

The everyday workflow is in DEVELOPERS.md.

10 skills in this repo

Copy into ~/.claude/skills

Al DevOps & Infrastructure

Execute the AlignFirst AAD protocol.

Install

git clone --depth 1 https://github.com/paleo/alignfirst
cp -r alignfirst/skills/al ~/.claude/skills/al

Alcatchup Productivity

Catch up with the current AlignFirst task: load its history, then continue with the user's instructions or summarize it.

Install

git clone --depth 1 https://github.com/paleo/alignfirst
cp -r alignfirst/skills/alcatchup ~/.claude/skills/alcatchup

Aldescription Writing & Editing

Execute the AlignFirst description protocol.

Install

git clone --depth 1 https://github.com/paleo/alignfirst
cp -r alignfirst/skills/aldescription ~/.claude/skills/aldescription

Alignfirst CC0 1.0

Collaborative problem-solving protocols. Read when the user names AlignFirst or a protocol alias: spec, alspec, plan, alplan, AAD, al, catchup, alcatchup, merge, almerge, alreview, or aldescription.

Install

git clone --depth 1 https://github.com/paleo/alignfirst
cp -r alignfirst/skills/alignfirst ~/.claude/skills/alignfirst

Alignfirst Developer Openclaw Playbook DevOps & Infrastructure CC0 1.0

Operating-instructions dispatcher for an AlignFirst Developer running on OpenClaw. Routes every user message by surface — thread → working session, channel/DM → channel handling — and carries the global rules.

Install

git clone --depth 1 https://github.com/paleo/alignfirst
cp -r alignfirst/skills/alignfirst-developer-openclaw-playbook ~/.claude/skills/alignfirst-developer-openclaw-playbook

Alignfirst Setup Guide DevOps & Infrastructure CC0 1.0

Install, upgrade, recommend, or combine AlignFirst skills, plans-share, docmap, and workspace in a consumer repository, or prepare a repository and Linux deployment for an AlignFirst Developer.

Install

git clone --depth 1 https://github.com/paleo/alignfirst
cp -r alignfirst/skills/alignfirst-setup-guide ~/.claude/skills/alignfirst-setup-guide

Almerge DevOps & Infrastructure

Execute the AlignFirst merge protocol.

Install

git clone --depth 1 https://github.com/paleo/alignfirst
cp -r alignfirst/skills/almerge ~/.claude/skills/almerge

Alplan

Execute the AlignFirst planning protocol.

Install

git clone --depth 1 https://github.com/paleo/alignfirst
cp -r alignfirst/skills/alplan ~/.claude/skills/alplan

Alreview

Execute the AlignFirst review protocol.

Install

git clone --depth 1 https://github.com/paleo/alignfirst
cp -r alignfirst/skills/alreview ~/.claude/skills/alreview

Alspec

Execute the AlignFirst specification protocol.

Install

git clone --depth 1 https://github.com/paleo/alignfirst
cp -r alignfirst/skills/alspec ~/.claude/skills/alspec

Comments (0)

No comments yet

Be the first to share your take.