atomika/aibook
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat(framework): add compliance gate, self-enforcement, and zip-based distribution #4

Merged
metacat merged 1 commit from feat/framework-compliance-gate into main 2026-05-05 09:49:47 +00:00
Conversation 0 Commits 1 Files changed 6 +398 -122
metacat commented 2026-05-05 09:47:55 +00:00
Owner
Copy link

Summary

This PR introduces framework-level self-enforcement mechanisms and changes the distribution model from git-clone to ZIP download.

Changes

Compliance & Enforcement

  • AGENTS.template (new): Replaces AGENTS.md with mandatory Agent Gate checklist, confirmation requirements, skill-first execution rule, and violation consequences
  • BOOT_AUTHORITY.yaml: Adds section with 7 mandatory reads, each with skip consequences
  • RULES.md: Adds Framework Compliance Violation rule with escalation matrix, strengthens skill verification requirements
  • HANDOVERS/framework_compliance_violation.md (new): Escalation matrix, violation report template, recorded violations log

Distribution Model

  • INSTALLATION.md: Replaced all instructions with ZIP download ( + UnZip 6.00 of 20 April 2009, by Info-ZIP. Maintained by C. Spieler. Send
    bug reports using http://www.info-zip.org/zip-bug.html; see README for details.

Usage: unzip [-Z] [-opts[modifiers]] file[.zip] [list] [-x xlist] [-d exdir]
Default action is to extract files in list, except those in xlist, to exdir;
file[.zip] may be a wildcard. -Z => ZipInfo mode ("unzip -Z" for usage).

-p extract files to pipe, no messages -l list files (short format)
-f freshen existing files, create none -t test compressed archive data
-u update files, create if necessary -z display archive comment only
-v list verbosely/show version info -T timestamp archive to latest
-x exclude files that follow (in xlist) -d extract files into exdir
modifiers:
-n never overwrite existing files -q quiet mode (-qq => quieter)
-o overwrite files WITHOUT prompting -a auto-convert any text files
-j junk paths (do not make directories) -aa treat ALL files as text
-U use escapes for all non-ASCII Unicode -UU ignore any Unicode fields
-C match filenames case-insensitively -L make (some) names lowercase
-X restore UID/GID info -V retain VMS version numbers
-K keep setuid/setgid/tacky permissions -M pipe through "more" pager
-O CHARSET specify a character encoding for DOS, Windows and OS/2 archives
-I CHARSET specify a character encoding for UNIX and other archives

See "unzip -hh" or unzip.txt for more help. Examples:
unzip data1 -x joe => extract all files except joe from zipfile data1.zip
unzip -p foo | more => send contents of foo.zip via pipe into program more
unzip -fo foo ReadMe => quietly replace existing ReadMe if archive file newer)

  • README.md: Updated all three installation methods to use ZIP download
  • AGENTS.template: Created from former AGENTS.md — host projects materialize this during init
  • Removed hardcoded git references (kept URL for fetching INSTALLATION.md)

Language Strengthening

  • MUST/STOP/FORBIDDEN replaces should/may/avoid throughout
  • Explicit violation consequences documented
  • Confirmation requirements for boot verification

Breaking Changes

  • None for existing initialized projects
  • New projects will get the self-enforcing AGENTS.md

Testing

  • Files staged and committed per repository boundary
  • Branch created:
  • No local state committed
## Summary This PR introduces framework-level self-enforcement mechanisms and changes the distribution model from git-clone to ZIP download. ## Changes ### Compliance & Enforcement - **AGENTS.template** (new): Replaces AGENTS.md with mandatory Agent Gate checklist, confirmation requirements, skill-first execution rule, and violation consequences - **BOOT_AUTHORITY.yaml**: Adds section with 7 mandatory reads, each with skip consequences - **RULES.md**: Adds Framework Compliance Violation rule with escalation matrix, strengthens skill verification requirements - **HANDOVERS/framework_compliance_violation.md** (new): Escalation matrix, violation report template, recorded violations log ### Distribution Model - **INSTALLATION.md**: Replaced all instructions with ZIP download ( + UnZip 6.00 of 20 April 2009, by Info-ZIP. Maintained by C. Spieler. Send bug reports using http://www.info-zip.org/zip-bug.html; see README for details. Usage: unzip [-Z] [-opts[modifiers]] file[.zip] [list] [-x xlist] [-d exdir] Default action is to extract files in list, except those in xlist, to exdir; file[.zip] may be a wildcard. -Z => ZipInfo mode ("unzip -Z" for usage). -p extract files to pipe, no messages -l list files (short format) -f freshen existing files, create none -t test compressed archive data -u update files, create if necessary -z display archive comment only -v list verbosely/show version info -T timestamp archive to latest -x exclude files that follow (in xlist) -d extract files into exdir modifiers: -n never overwrite existing files -q quiet mode (-qq => quieter) -o overwrite files WITHOUT prompting -a auto-convert any text files -j junk paths (do not make directories) -aa treat ALL files as text -U use escapes for all non-ASCII Unicode -UU ignore any Unicode fields -C match filenames case-insensitively -L make (some) names lowercase -X restore UID/GID info -V retain VMS version numbers -K keep setuid/setgid/tacky permissions -M pipe through "more" pager -O CHARSET specify a character encoding for DOS, Windows and OS/2 archives -I CHARSET specify a character encoding for UNIX and other archives See "unzip -hh" or unzip.txt for more help. Examples: unzip data1 -x joe => extract all files except joe from zipfile data1.zip unzip -p foo | more => send contents of foo.zip via pipe into program more unzip -fo foo ReadMe => quietly replace existing ReadMe if archive file newer) - **README.md**: Updated all three installation methods to use ZIP download - **AGENTS.template**: Created from former AGENTS.md — host projects materialize this during init - Removed hardcoded git references (kept URL for fetching INSTALLATION.md) ### Language Strengthening - MUST/STOP/FORBIDDEN replaces should/may/avoid throughout - Explicit violation consequences documented - Confirmation requirements for boot verification ## Breaking Changes - None for existing initialized projects - New projects will get the self-enforcing AGENTS.md ## Testing - [x] Files staged and committed per repository boundary - [x] Branch created: - [x] No local state committed
- Add mandatory Agent Gate checklist to AGENTS.template with confirmation requirement
- Add compliance_gate section to BOOT_AUTHORITY.yaml with mandatory reads
- Add Framework Compliance Violation rule and escalation matrix to RULES.md
- Create HANDOVERS/framework_compliance_violation.md with violation templates
- Convert AGENTS.md to AGENTS.template for host project materialization
- Update INSTALLATION.md: replace git clone with zip download instructions
- Update README.md: reflect zip-based installation methods
- Remove all hardcoded git references to framework project
- Strengthen language: MUST/STOP/FORBIDDEN replaces should/may/avoid
metacat deleted branch feat/framework-compliance-gate 2026-05-05 09:49:47 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
atomika/aibook!4
No description provided.