Codex Write an ADR for an Architectural Choice and Its Consequences
Record context, drivers, options, decision status, and consequences in an architecture decision record.
中文Install in Codex
Provide an agreed choice or open options, relevant constraints, and traceable evidence.
- Copy the pinned `skills/codexkit-architecture-decision-writer/` directory into `.agents/skills/codexkit-architecture-decision-writer/` in the project.
- Tell Codex the decision status, scope, and existing ADR format. List the decision drivers first.
Example task
Compare process-local and shared caching for a demo. Supply multi-instance consistency needs, operating costs, and expected volume. Keep status Proposed.What to check
The ADR identifies options, evidence, tradeoffs, and review conditions, with a status that matches the actual decision.
Original SKILL.md on GitHub · Updated
Frequently asked question
Should a new choice rewrite the older ADR?
Preserve the original rationale and record its superseding relationship and date in the new ADR.