Skip to Content
Tasknest
Architecture Decisions

Architecture Decision Records

Accepted design decisions guiding Tasknest's architecture.

All Architecture Decision Records (ADRs) live in backlog/decisions/ in the repository:

ADRDecision
decision-1Native-language runners (tasknest-py, tasknest-ts) with shared conventions
decision-2File-based task discovery (one task per file) and strict validation
decision-3CLI task paths and direct typed arguments without mandatory --
decision-4Explicit task metadata (depends, marks, requires)
decision-5Bootstrap repository automation with doit until Tasknest existed (now self-hosted in tools/)
decision-6Conservative affected test selection with full-suite fallback
decision-7Optional ecosystem adapters and reusable plugin interfaces
decision-8Opt-in content-hashed caching and explicit execution effects
decision-9Structured ctx.output(...), read-only ctx.deps[...], and scoped ctx.env(...)