claudiomaradonna/agent-foundry
claudiomaradonna/agent-foundry
Template
1
0
Fork 0
Code Issues Pull requests Activity

Redesign Agent Foundry as a validated one-time repository seed #1

Merged
claudiomaradonna merged 10 commits from feature/agent-foundry-redesign into main 2026-08-28 17:09:00 +02:00
Conversation 0 Commits 10 Files changed 10 +2773 -433
claudiomaradonna commented 2026-08-28 15:12:36 +02:00
Owner
Copy link

Summary

Redesign Agent Foundry as a small, safe, portable one-time repository seed for projects developed with coding agents.

This resolves the source-template lifecycle ambiguity, reduces always-loaded instruction weight, mechanically validates supported configurations, and clarifies the boundaries of optional LocalRecall, LocalAI, and LocalAGI usage.

Key changes

  • Add explicit template and initialized lifecycle states.
  • Rewrite the source README with initialization and adoption workflows.
  • Compact AGENTS.md while retaining continuity, security, testing, and delivery protections.
  • Add a host-neutral Bash validator for:
  • lifecycle and placeholder state;
  • project commands;
  • memory profiles and collection identifiers;
  • Claude/Codex adapter consistency;
  • tracked local-only files;
  • JSON and whitespace validity.
  • Add 35 disposable Git-fixture validation cases.
  • Define four memory profiles:
  • none;
  • localrecall-read-only;
  • localrecall-single-writer;
  • localrecall-gateway.
  • Harden the LocalRecall contract around trust, access, concurrency, retention, backups, embedding reproducibility, and evaluation.
  • Keep stock LocalRecall MCP read-only for coding agents.
  • Keep LocalAGI outside the project-memory architecture.
  • Add the MIT License with:
    Copyright (c) 2026 Claudio Maradonna.
  • Ignore machine-local Claude settings while retaining the intentional repository attribution settings.

Validation

  • bash tests/verify-agent-config.sh
  • 35/35 cases passed.
  • bash tests/verify-localrecall-contract.sh
  • Contract verification passed.
  • scripts/verify-agent-config.sh
  • Reported state=template.
  • Shell syntax and tracked JSON validation passed.
  • Bash 3.2 compatibility paths passed with Bash-4-only mapfile disabled.
  • Protected Claude bridge and settings assertions passed.
  • Full tracked-state and commit-range whitespace checks passed.
  • Independent task reviews and a final whole-branch review completed.
  • All final-review findings were fixed and re-reviewed.

Notes

  • The repository intentionally remains in source template state.
  • Placeholder project commands were not executed.
  • No production dependencies or provider-specific CI configuration were added.
  • No LocalRecall, LocalAI, LocalAGI, gateway, or other external service was deployed or contacted.
  • CLAUDE.md remains exactly @AGENTS.md.
  • .claude/settings.json remains byte-for-byte unchanged.
## Summary Redesign Agent Foundry as a small, safe, portable one-time repository seed for projects developed with coding agents. This resolves the source-template lifecycle ambiguity, reduces always-loaded instruction weight, mechanically validates supported configurations, and clarifies the boundaries of optional LocalRecall, LocalAI, and LocalAGI usage. ## Key changes - Add explicit `template` and `initialized` lifecycle states. - Rewrite the source README with initialization and adoption workflows. - Compact `AGENTS.md` while retaining continuity, security, testing, and delivery protections. - Add a host-neutral Bash validator for: - lifecycle and placeholder state; - project commands; - memory profiles and collection identifiers; - Claude/Codex adapter consistency; - tracked local-only files; - JSON and whitespace validity. - Add 35 disposable Git-fixture validation cases. - Define four memory profiles: - `none`; - `localrecall-read-only`; - `localrecall-single-writer`; - `localrecall-gateway`. - Harden the LocalRecall contract around trust, access, concurrency, retention, backups, embedding reproducibility, and evaluation. - Keep stock LocalRecall MCP read-only for coding agents. - Keep LocalAGI outside the project-memory architecture. - Add the MIT License with: `Copyright (c) 2026 Claudio Maradonna`. - Ignore machine-local Claude settings while retaining the intentional repository attribution settings. ## Validation - `bash tests/verify-agent-config.sh` - 35/35 cases passed. - `bash tests/verify-localrecall-contract.sh` - Contract verification passed. - `scripts/verify-agent-config.sh` - Reported `state=template`. - Shell syntax and tracked JSON validation passed. - Bash 3.2 compatibility paths passed with Bash-4-only `mapfile` disabled. - Protected Claude bridge and settings assertions passed. - Full tracked-state and commit-range whitespace checks passed. - Independent task reviews and a final whole-branch review completed. - All final-review findings were fixed and re-reviewed. ## Notes - The repository intentionally remains in source `template` state. - Placeholder project commands were not executed. - No production dependencies or provider-specific CI configuration were added. - No LocalRecall, LocalAI, LocalAGI, gateway, or other external service was deployed or contacted. - `CLAUDE.md` remains exactly `@AGENTS.md`. - `.claude/settings.json` remains byte-for-byte unchanged.
claudiomaradonna deleted branch feature/agent-foundry-redesign 2026-08-28 17:09:02 +02: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
claudiomaradonna/agent-foundry!1
No description provided.