Skip to content

docs(spec-loop): show helpers and tests in layout#893

Merged
potiuk merged 2 commits into
apache:mainfrom
nightcityblade:docs/issue-873
Jul 15, 2026
Merged

docs(spec-loop): show helpers and tests in layout#893
potiuk merged 2 commits into
apache:mainfrom
nightcityblade:docs/issue-873

Conversation

@nightcityblade

Copy link
Copy Markdown
Contributor

Summary

  • Add the existing lib.sh and tests/ entries to the spec-loop layout diagram.
  • Update the tree connectors so the documented hierarchy remains accurate.

Type of change

  • Skill change (.claude/skills/<name>/) — eval fixtures updated below
  • Tool / bridge contract (tools/<system>/*.md)
  • Python package (tools/*/ with pyproject.toml)
  • Groovy reference impl
  • Cross-cutting (RFC, AGENTS.md, sandbox, privacy-LLM)
  • Documentation (docs/, README.md, CONTRIBUTING.md)
  • Project template (projects/_template/)
  • CI / dev loop (prek, workflows, validators)
  • Other: N/A

Test plan

  • prek run --all-files passes
  • For Python packages touched: uv run pytest / ruff check / mypy passes — N/A (documentation-only change)
  • For Groovy bridges touched: command-line invocation tested end-to-end — N/A
  • For skill changes: eval suite passes for the affected skill
    (PYTHONPATH=tools/skill-evals/src python3 -m skill_evals.runner tools/skill-evals/evals/<skill>/) — N/A
  • For skill behaviour changes: a new or updated eval fixture is included in this PR
    (a regression test for the bug fixed / the behaviour added — see CONTRIBUTING.md) — N/A
  • Other: git diff --check

RFC-AI-0004 compliance

N/A — this documentation-only layout correction introduces no mutations,
host access, vendor coupling, agent behaviour, write access, or private-data flow.

  • HITL — any new mutation is gated on explicit user confirmation
  • Sandbox — no new unrestricted host access; network reach declared in the adapter
  • Vendor neutrality — placeholders (<PROJECT>, <tracker>, <upstream>, <security-list>) used in all skill / tool prose (the check-placeholders prek hook is the mechanical gate)
  • Conversational + correctable — agentic-override path documented if behaviour is adopter-tunable
  • Write-access discipline — no autonomous outbound messages; drafts only, sent on confirmation
  • Privacy LLM — private content does not reach a non-approved LLM; redactor invoked where needed

Linked issues

Closes #873

Notes for reviewers (optional)

The descriptions for lib.sh and tests/ reflect their current roles in the
spec-loop runner and fixture suite.

Generated-by: Codex (GPT-5)

nightcityblade and others added 2 commits July 15, 2026 23:27
@potiuk
potiuk merged commit 848c2cb into apache:main Jul 15, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs/spec-driven-development.md: layout tree missing lib.sh and tests/

3 participants