Alku

Alku is a meta-framework for modern autonomous agentic development.

Features

Alku bundles and installs several skills:

1. alku-workflow — main entrypoint; responsible for a complete plan-to-implementation workflow for a single feature. Automatically added to AGENTS.md.
2. alku-auto — autonomous long-term development; takes all planned features and sequentially launches alku-workflow subagents for each one.
3. alku-brainstorm — check current project features and create plans for future project growth; launch when you have no idea what to do with the project.
4. alku-docs — generate, check, and reconcile documentation with code; should be run periodically (every 3 features as a baseline) to avoid mess and drift in documentation.
5. alku-architecture — check high-level project structure; should be run periodically (every 3 features as a baseline) to avoid project structure from becoming a mess.

Alku takes completely ownership on the root docs directory and uses it for project documentation.

Install

Until a public release exists, install Alku from a checkout:

uv tool install --force .
uv tool update-shell

Restart the shell if uv tool update-shell changes PATH. After publication, uv tool install alku will install the packaged release.

Quick start

To add Alku to the project run alku init, it will:

1. Run applicable versioned migrations for an existing Alku project;
2. Create the docs directory;
3. Update the managed AGENTS.md gate and make CLAUDE.md import it;
4. Install bundled skills for OpenAI and Claude;
5. Install provider-native named agent profiles with role-specific effort;
6. Ask about optional integrations and external-agent handoffs when interactive;

After that, launch a new agent session and you're done.

Documentation

• Documentation index
• Command reference
• Architecture
• Operations
• Development
• Release readiness

Alku manages product, feature, and proposal records beneath docs/. The collection model defines the record kinds, and the validation contract defines their allowed structure and integrity rules.

Development

uv sync
uv run pytest
uv run ruff check .
uv run ruff format --check .
uv run ty check --extra-search-path src .
uv build

The test configuration requires 100% line coverage. See the development guide for the change workflow and explicit large-repository regression command.