🌐 Online version: 12-factor.airic.dev
The Human–AI Collaborative Development (HAI‑CD) Manifesto is a set of twelve principles for building software in the age of large language models (LLMs).
It is inspired by the Twelve-Factor App but focused on the reality that AI programming will remain semi‑autonomous for the foreseeable future. Humans provide the system narrative, architecture, and accountability, while AI accelerates implementation, documentation, and exploratory design.
Much like autonomous driving:
- The demos look impressive, yet the "last 1%" of reliability remains unsolved.
- In practice, the future is semi‑autonomous: adaptive cruise control rather than full autopilot.
Software is the same. Great systems always have a continuous narrative carried by human architects. AI can significantly accelerate development, but without constraints it risks fragmenting the system. These principles provide a framework for effective human‑at‑the‑helm collaboration with AI.
This manifesto is principle‑oriented. Practical metrics, case studies, and experiments will be collected in this repository.
- Open an discuss to propose feedback or share experiences.
- Submit pull requests for case studies, documentation improvements, or translations.
- Join the discussion: what does good collaboration with AI look like in your workflow?
This work is licensed under a Creative Commons Attribution 4.0 International License (CC BY 4.0).
- Inspired by the Twelve-Factor App.
- Built from ongoing discussions on the future of semi‑autonomous AI programming.
- Online version of the manifesto maintained by the community.