Recommended reading order
Projects, Features, and Work Cards
Understand product scope, one in-flight Feature, and repository-scoped work in Linear.
The lifecycle of a Night
Follow author, build, and land Acts through local execution and reporting.
Verification and Definition of Done
Read clause-level evidence and distinguish unmet, unresolved, and unchecked criteria.
Local execution and credentials
Understand local orchestration, external services, and permission boundaries.
The core objects
A Project groups one product’s repositories, specification source, Linear project, and configuration. A Feature describes an intended outcome. Its Work Cards carry the repository-scoped pieces of work. A Night is a scheduled window of activity for a Project. One Feature is in flight at a time, but several can land sequentially during the same Night. Landed Features can remain in the unmerged stack while you review their pull requests.Planned relationship diagram
Yellowhammer core objectsShow how Projects, Nights, Features, Work Cards, and Night Summaries relate.