Skip to content

feat: ADR directory detection should scan one level of subdirectories for .md files #423

Closed as not planned

Description

@jwm4

Problem

The current ADR assessor counts .md files directly inside the matched directory (e.g. docs/specs/*.md). Some repos organize their specs into numbered subdirectories within that directory, causing false negatives.

Example: liatrio-labs/spec-driven-workflow has:

docs/specs/
  01-spec-ai-techniques-deep-dive-page/
    01-spec-ai-techniques-deep-dive-page.md
    01-audit-ai-techniques-deep-dive-page.md
    01-tasks-ai-techniques-deep-dive-page.md
    01-validation-ai-techniques-deep-dive-page.md
    01-proofs/

The numbered subdirectory naming convention (01-, 02-, ...) is characteristic of ADR-style sequential organization. However, because the .md files are one level below the matched directory, the assessor finds zero files and scores this as a fail.

Proposed Fix

When the assessor finds a matched ADR directory, count .md files both directly in that directory AND in immediate subdirectories (one level deep). Do not recurse further to avoid pulling in unrelated nested docs.

Expected Outcome

  • liatrio-labs/spec-driven-workflow: docs/specs/ (currently fails with score 40) should pass, since it contains 4+ .md files one level down.
  • Repos with flat .md layouts (e.g. bdfinst/agentic-dev-team) continue to pass unchanged.
  • Repos with deeply nested or unrelated docs are not affected.

Context

Discovered while validating PR #415 against real-world repos. This is a separate limitation from the ADR directory name list and affects all directory name candidates, not just specs.

🤖 Generated with Claude Code under the supervision of Bill Murdock

Activity

  1. github-actions commented on Jul 12, 2026

    @github-actions
    Contributor

    👋 This issue has been inactive for 60 days and will be closed in 30 days if there is no further activity.

    If this issue is still relevant, please:

    • Add a comment with updates
    • Remove the stale label
    • Add the pinned label to prevent future stale marking

    Thank you for your contributions to AgentReady!

  2. github-actions commented on Aug 11, 2026

    @github-actions
    Contributor

    🔒 This issue has been automatically closed due to 90 days of inactivity.

    If you believe this issue should remain open, please reopen it and provide an update.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions