01
Sources
Distinguish authoritative files from context; preserve exact copy when required.
Open-source language · v0.1
Awen Lang
Assembly sheets for AI production.
Awen Lang is a small declarative language for handing settled project decisions and their source files to an AI agent or toolchain.
02
Requirements
Define behaviour, requirements, preferences and prohibited choices.
03
Approvals
Set human approval boundaries and flag unresolved decisions.
04
Completion
Set acceptance criteria and verify them with tests or review.
project.awen
AWEN 0.1
PROJECT ZeroReel
OUTPUT film search feature
ROOT .
REPOSITORY
MODE existing
ROOT .
SOURCES
PRODUCT ./docs/product.md AUTHORITATIVE
SEARCH ./docs/search.md AUTHORITATIVE
REQUIRE
search published films by title
preserve existing discovery flow
accessible keyboard interaction
PREFER
progressive enhancement
CSS OVER JavaScript
APPROVAL
HUMAN database schema changes
DONE WHEN
search returns matching published films
existing tests passThis example adds film search to an existing project and requires approval for database changes.
How to use it
Disciplined vibe coding.
Settle the important decisions, then hand over a .awen sheet and the relevant files. It describes what to produce, what must be preserved and which temporary substitutes are acceptable. Use it for new work or changes to an existing project.
The format is independent of any model or vendor. A capable agent or toolchain reads the sheet directly, produces the output and checks it against the acceptance criteria. Approval and verification are carried out by that agent, toolchain or a human.
Read the workflow →The name
Why “Awen”?
Awen is a Welsh word associated with inspiration, especially poetic or creative inspiration. In Welsh bardic tradition, awen is the creative force behind the work of the poet or maker. For Awen Lang, inspiration becomes useful through discipline, structure and craft.
Documentation
Agent discovery
This site provides a Markdown version, structured metadata and llms.txt to help agents find the specification and repository.