Root cause fix for AI agent failing to commit/push automatically:
1. Added Task Completion Checklist to AGENTS.md with mandatory items:
- All requested work implemented
- Changes staged (git add)
- Changes committed (conventional format)
- Changes pushed (git push)
- STATUS.md updated (if applicable)
- JOURNAL.md updated (if applicable)
2. Added pre-push hook in .githooks/ (tracked, not .git/hooks/):
- Blocks push if uncommitted changes exist
- Safety net if checklist is skipped
3. Fixed .gitignore: changed "vendor/" to "vendor" to also ignore symlink
After cloning, run: git config core.hooksPath .githooks
💘 Generated with Crush
Assisted-by: GLM-5 via Crush <crush@charm.land>
Root cause fix for AI agent failing to commit/push automatically:
- Added explicit Task Completion Checklist section to AGENTS.md
- Added pre-push git hook to block push if uncommitted changes exist
The checklist forces verification of commit/push before declaring work done.
The git hook provides safety net if checklist is skipped.
Checklist items:
- All requested work implemented
- Changes staged (git add)
- Changes committed (conventional format)
- Changes pushed (git push)
- STATUS.md updated (if applicable)
- JOURNAL.md updated (if applicable)
DO NOT STOP until all applicable items complete.
💘 Generated with Crush
Assisted-by: GLM-5 via Crush <crush@charm.land>
AGENTS.md now contains only AI agent rules/guidelines:
- Commit Policy, SDLC Compliance, Status Tracking, Journal Maintenance
- Project Conventions, Crush Configuration, Validation Checklist
- MCP Handshake Command example
- References to other documentation files instead of duplicating content
README.md now contains comprehensive project documentation:
- Full MCP/LSP server inventory tables (30+ servers organized by category)
- Server technologies by language (TypeScript, Python, Go, Rust, Prebuilt)
- Environment variables reference table for all services
- Installation, usage, troubleshooting guides
- Crush integration configuration examples
This refactoring ensures:
- AGENTS.md is a concise reference for AI agent behavior (~107 lines)
- README.md is the comprehensive project documentation (~424 lines)
- No duplication between files
- Each file has a single responsibility
💔 Generated with Crush
Assisted-by: GLM-5 via Crush <crush@charm.land>
Added mandatory callout at top of AGENTS.md:
- AI agents MUST commit and push changes automatically WITHOUT prompting
- Use atomic commits (one logical change per commit)
- Use conventional format (feat:, fix:, docs:, build:, refactor:, test:)
- Verbose commit messages required
Updated Development Notes section:
- Added "SDLC Compliance (REQUIRED)" section with link to docs/SDLC.md
- Documented mandatory MCP handshake command
- Updated Validation Checklist to emphasize protocol handshake is MANDATORY
This ensures AI agents understand that committing is automatic,
not something to ask permission for.
- Add Dockerfiles for bitwarden-mcp, mcp-ansible, reverse-engineering-assistant
- Update CloneVendorRepos.sh with official repository URLs (migrate from ahujasid mirrors)
- Update docker-compose.yml with new services and reorganization
- Update STATUS.md with current operational status of all MCP servers
- Update AGENTS.md with webserial-mcp and terraform-ls documentation
- Add journal entries for recent work (ADRs, insights, patterns)
💔 Generated with Crush
Assisted-by: GLM-5 via Crush <crush@charm.land>
Document marksman Markdown LSP build and validation success.
Changes:
- STATUS.md: Added marksman as validated LSP (2025-12-13, 144MB)
- AGENTS.md: Added marksman to Development Tools section
- AGENTS.md: Updated server counts (Development Tools: 3→4)
Validation:
- Container builds successfully from custom Dockerfile
- Version 2025-12-13 verified with --version flag
- Crush wrapper script functional
- All three LSP servers (bash, docker, marksman) now working
- AGENTS.md: Update all 29 container names in tables and Crush integration examples
- README.md: Update container names in Crush integration, troubleshooting, and project structure examples
- STATUS.md: Update container prefix note to reflect new naming convention
Aligns documentation with docker-compose.yml changes for consistency.
- Document crush.json format and configuration
- Explain configuration priority (local to global)
- Provide Docker-based LSP/MCP configuration pattern
- Include examples for bash, docker, and markdown LSP servers
Removed Status column from all tables to eliminate duplication
Added prominent note about STATUS.md being single source of truth
Added comprehensive STATUS.md maintenance instructions
Emphasized that STATUS.md must be kept current at all times
Commit STATUS.md updates in separate atomic commits
💘 Generated with Crush
Co-Authored-By: Crush <crush@charm.land>
Add penpot-mcp to Additional Tools section.
Add environment variable reference for PENPOT_URL and PENPOT_TOKEN.
💘 Generated with Crush
Assisted-by: GLM-4.7 via Crush <crush@charm.land>
Add host-only requirement to KiCAD MCP description.
Add KICAD_HOST and KICAD_PORT environment variables
with default values for Docker Desktop compatibility.
Add development note about KiCAD host installation requirement.
💘 Generated with Crush
Assisted-by: GLM-4.7 via Crush <crush@charm.land>
Document all 27 MCP servers including:
- Categorized overview by function and language
- Detailed capability descriptions
- Environment variable reference table
- Quick start commands
- Validation checklist
- Development notes and references
💘 Generated with Crush
Assisted-by: GLM-4.7 via Crush <crush@charm.land>
