TEMPLATE-STANDARDS-AUDIT.adoc

Template Standards Audit

Table of Contents

• 1. Scope And Inventory
• 2. Claim Vs Actual
• 3. Classification
  • 3.1. Authoritative Shared Standard
  • 3.2. Repo-Local Binding/Integration
  • 3.3. Generated Runtime Artifact
  • 3.4. Obsolete/Duplicate/Drifted
• 4. Move/Stay/Delete Guidance
  • 4.1. Move Into standards
  • 4.2. Stay In rsr-template-repo
  • 4.3. Delete/Archive
• 5. Missing-But-Expected Session Files (Template Repo)
• 6. Proposed Final Directory Map
• 7. Maintenance Model Note

1. Scope And Inventory

Audit scope:

• Repository: rsr-template-repo

• Focus: root authority docs/manifests, Justfile integration, session bindings

• Recursive inventory method: rg --files -g '!.git' | sort

Inventory snapshot at audit time:

• rsr-template-repo total tracked files discovered: 240

• Session-local binding files discovered: 4 under session/ plus coordination.k9

2. Claim Vs Actual

Claimed item	Claimed by	Expected path	Actual status	Notes	Recommended action
Placeholder badge tokens in README	README.adoc	{{OPENSSF_PROJECT_ID}}, hyperpolymath, nextgen-typing	placeholder	Template placeholders are intentional pre-bootstrap content.	Keep; document clearly as template tokens.
Docs links used .adoc files not present	legacy README.adoc (pre-migration)	CONTRIBUTING.adoc, GOVERNANCE.adoc, SECURITY.adoc	outdated	Actual files are CONTRIBUTING.md, no root GOVERNANCE.adoc, SECURITY.md.	Fixed README links to existing files.
ABI path lower-case only	legacy README.adoc + legacy checks	src/interface/abi/*.idr	outdated	Current tree has src/interface/Abi/*.idr (uppercase A).	Updated docs/checks to accept current path.
Root manifest structure with non-existent files	legacy 0-AI-MANIFEST.a2ml (pre-migration)	GOVERNANCE.adoc, several strict root assumptions	outdated	Manifest claims did not match actual template contents.	Replaced with accurate authority split + startup checklist.
Source-human references maintenance/practice docs	legacy Justfile + policy A2ML (pre-migration)	docs/maintenance/…​, docs/practice/SOFTWARE-DEVELOPMENT-APPROACH.adoc	outdated	Those paths did not exist in template.	Updated to docs/governance/…​ paths.
Session-management local binding files	target architecture	session/README.md, session/custom-checks.k9, session/local-hooks.sh, coordination.k9	exists	Added as thin integration layer without protocol duplication.	Keep.
Canonical command mapping in local automation	target architecture	Justfile session aliases + session/dispatch.sh	exists	All canonical commands map to dispatcher.	Keep.
Central protocols are authoritative	README.adoc, 0-AI-MANIFEST.a2ml, AUDIT.adoc	standards/session-management-standards/	exists	Local docs now explicitly defer protocol authority to standards repo.	Keep.
Runtime session artifacts stay per-repo	session/README.md, session/dispatch.sh	.session/ in target repo path	exists	Dispatcher records canonical commands into runtime .session/ files.	Keep runtime artifacts out of authoritative standards docs.
Local policy hooks remain local	session/local-hooks.sh, session/custom-checks.k9	local session binding layer	exists	Policy/hook logic separated from central protocol definitions.	Keep local-only.

3. Classification

3.1. Authoritative Shared Standard

• External to this repo: standards/session-management-standards/*

3.2. Repo-Local Binding/Integration

• Justfile canonical session aliases

• session/dispatch.sh

• session/custom-checks.k9

• session/local-hooks.sh

• session/README.md

• coordination.k9

• AUDIT.adoc (local gate summary)

3.3. Generated Runtime Artifact

• .session/* outputs created by local dispatcher per repository path

3.4. Obsolete/Duplicate/Drifted

• Legacy path assumptions (docs/maintenance/, docs/practice/ for governance policy references)

• Legacy root-doc claims to files not present in this template

• Legacy lower-case-only ABI path references

4. Move/Stay/Delete Guidance

4.1. Move Into standards

• Any future full protocol text drafts should move to standards/session-management-standards/.

4.2. Stay In rsr-template-repo

• Local aliases, hooks, coordination wiring, and repo-local checks.

4.3. Delete/Archive

• Archive or remove legacy references to non-existent docs/paths if reintroduced.

• Avoid reintroducing full duplicated protocol definitions.

5. Missing-But-Expected Session Files (Template Repo)

Template repo expected only thin local integration files.

Current status:

• No mandatory thin-binding files are missing.

• Full protocol directories/files are intentionally absent here by design.

6. Proposed Final Directory Map

rsr-template-repo/
  README.adoc
  AUDIT.adoc
  0-AI-MANIFEST.a2ml
  EXPLAINME.adoc
  Justfile
  coordination.k9
  session/
    README.md
    dispatch.sh
    custom-checks.k9
    local-hooks.sh
  docs/
    ... (repo-local human docs)
  .machine_readable/
    ... (repo-local machine-readable policy/state)

7. Maintenance Model Note

• Protocols central: maintained in standards/session-management-standards/.

• Policy local: maintained in template/downstream repos (session/*.k9, hooks, coordination bindings).

• State per-repo: generated during execution (.session/*) in the active working repository.