Bug Description
The architecture_decisions assessor reports 0/100, no ADR directory found on repos that follow the docs/ADRs/ (capital A) or docs/Adr/ naming convention. The candidate-directory list in the assessor is case-sensitive, so common capital-letter variants are missed even when ADRs are clearly present.
To Reproduce
Steps to reproduce the behavior:
- Clone a repo with ADRs at
docs/ADRs/ (capital A). Concrete example:
git clone https://github.com/fullsend-ai/fullsend /tmp/fullsend
cd /tmp/fullsend && git checkout cba01190
ls docs/ADRs/ # 11 ADR files
- Run
agentready assess .
- See
architecture_decisions ❌ FAIL — no ADR directory (need: ADR directory with decisions) in the output.
Expected Behavior
The assessor should detect the ADR directory regardless of case (adr, ADR, Adr, ADRs, Adrs) and pass, since 11 numbered ADRs (0001-…md through 0010-…md) are present and follow the Michael Nygard format the remediation guidance recommends.
Actual Behavior
Reports 0/100 with evidence No ADR directory found (checked docs/adr/, .adr/, adr/, docs/decisions/). The capitalised variants are not in the candidate list.
Environment
- OS: macOS 25.4.0 (Darwin arm64)
- Version: agentready 2.31.2
- Python Version: 3.12
Additional Context
docs/ADRs/ and docs/Adrs/ are common conventions — they appear in repos that consider ADRs first-class artifacts and want them to sort visually with other capitalised top-level docs (README.md, CONTRIBUTING.md).
Capital-A variants also surface in template-driven repos derived from common ADR scaffolds.
Possible Solution
Two options:
- Case-insensitive directory match — match
docs/adr* regardless of case. Lowest effort; risks matching unrelated dirs like docs/adr-discussion/ if they exist.
- Expand the candidate list to include
docs/ADRs/, docs/ADR/, docs/Adr/, docs/Adrs/. Explicit and safer; needs maintenance if new conventions appear.
(2) is probably the right call — it preserves the existing precision while covering the realistic capitalisation patterns.
Bug Description
The
architecture_decisionsassessor reports0/100, no ADR directory foundon repos that follow thedocs/ADRs/(capital A) ordocs/Adr/naming convention. The candidate-directory list in the assessor is case-sensitive, so common capital-letter variants are missed even when ADRs are clearly present.To Reproduce
Steps to reproduce the behavior:
docs/ADRs/(capital A). Concrete example:agentready assess .architecture_decisions ❌ FAIL — no ADR directory (need: ADR directory with decisions)in the output.Expected Behavior
The assessor should detect the ADR directory regardless of case (
adr,ADR,Adr,ADRs,Adrs) and pass, since 11 numbered ADRs (0001-…mdthrough0010-…md) are present and follow the Michael Nygard format the remediation guidance recommends.Actual Behavior
Reports
0/100with evidenceNo ADR directory found (checked docs/adr/, .adr/, adr/, docs/decisions/). The capitalised variants are not in the candidate list.Environment
Additional Context
docs/ADRs/anddocs/Adrs/are common conventions — they appear in repos that consider ADRs first-class artifacts and want them to sort visually with other capitalised top-level docs (README.md,CONTRIBUTING.md).Capital-A variants also surface in template-driven repos derived from common ADR scaffolds.
Possible Solution
Two options:
docs/adr*regardless of case. Lowest effort; risks matching unrelated dirs likedocs/adr-discussion/if they exist.docs/ADRs/,docs/ADR/,docs/Adr/,docs/Adrs/. Explicit and safer; needs maintenance if new conventions appear.(2) is probably the right call — it preserves the existing precision while covering the realistic capitalisation patterns.