(magpie) branch main updated: docs(spec-loop): drop resolved org-adapter validator gap (#994)

[jm...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

justinmclean pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/magpie.git


The following commit(s) were added to refs/heads/main by this push:
     new 481a9b5d docs(spec-loop): drop resolved org-adapter validator gap (#994)
481a9b5d is described below

commit 481a9b5d4b90c672323bf4a02beedfbcd901fa6f
Author: Vishnu Mangipudi <59...@users.noreply.github.com>
AuthorDate: Tue Jul 28 22:57:03 2026 -0700

    docs(spec-loop): drop resolved org-adapter validator gap (#994)
---
 tools/spec-loop/specs/organization-adapters.md | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/tools/spec-loop/specs/organization-adapters.md b/tools/spec-loop/specs/organization-adapters.md
index 841b8acb..ee1b542f 100644
--- a/tools/spec-loop/specs/organization-adapters.md
+++ b/tools/spec-loop/specs/organization-adapters.md
@@ -116,15 +116,18 @@ Manual resolution check: a `project.md` with `organization: ASF` and a
 key omitted resolves to the ASF adapter value; `organization: independent`
 resolves to the baseline.
 
+Adapter layout is enforced: `validate_organization_structure` in
+`tools/skill-and-tool-validator` requires every `organizations/<org>/`
+directory except `_template` to contain `README.md` and `organization.md`.
+Omitting either results in a HARD violation, so an incomplete adapter fails
+the validator before any skill can resolve against it.
+
 ## Known gaps
 
 - The reflow of `projects/_template/` + `projects/non-asf-example/` to
   set `organization:` and drop the now-inherited values is not yet done
   (tracked as the next change); until then the ASF defaults exist in both
   `projects/_template/project.md` and `organizations/ASF/`.
-- No structural validator check yet enforces required files in
-  `organizations/<org>/` (currently README + organization.md by
-  convention).
 - The family-level `organization:` scope (replacing `asf: true/false`)
   and the external-adapter discovery index are separate follow-ups.
 - **Smoke coverage is narrow.** The non-ASF profile smoke currently proves