docs: define v0.1 product and architecture contract
This commit is contained in:
parent
57597e7d6d
commit
c4fb0c6a01
12 changed files with 2130 additions and 64 deletions
13
docs/adr/0003-default-to-json-everywhere.md
Normal file
13
docs/adr/0003-default-to-json-everywhere.md
Normal file
|
|
@ -0,0 +1,13 @@
|
|||
---
|
||||
status: accepted
|
||||
---
|
||||
|
||||
# Default to JSON everywhere
|
||||
|
||||
Automation agents are the primary consumers, so the shortest invocation must
|
||||
produce the stable machine interface. The CLI defaults to JSON regardless of
|
||||
whether stdout is a terminal or pipe; human-readable presentation requires
|
||||
`--format human`. Avoiding TTY-dependent format selection ensures that the same
|
||||
command has the same framing and semantics in every execution environment.
|
||||
JSON mode never emits interactive prompts; required confirmation is represented
|
||||
as a structured error and satisfied by an explicit flag.
|
||||
Loading…
Add table
Add a link
Reference in a new issue