{"id":51428161,"url":"https://github.com/suradet-ps/agentforge-rs","last_synced_at":"2026-07-05T02:30:29.350Z","repository":{"id":353778854,"uuid":"1220718963","full_name":"suradet-ps/agentforge-rs","owner":"suradet-ps","description":"The official cargo subcommand to bootstrap AI-ready Rust projects with AGENTS-RUST.md. One command. Zero configuration. Production-grade AI rules delivered instantly.","archived":false,"fork":false,"pushed_at":"2026-04-25T13:00:57.000Z","size":12,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-25T15:04:42.947Z","etag":null,"topics":["agents","cargo-subcommand","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/suradet-ps.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-25T08:34:42.000Z","updated_at":"2026-04-25T13:01:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/suradet-ps/agentforge-rs","commit_stats":null,"previous_names":["suradet-ps/agentforge-rs"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/suradet-ps/agentforge-rs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suradet-ps%2Fagentforge-rs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suradet-ps%2Fagentforge-rs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suradet-ps%2Fagentforge-rs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suradet-ps%2Fagentforge-rs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/suradet-ps","download_url":"https://codeload.github.com/suradet-ps/agentforge-rs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/suradet-ps%2Fagentforge-rs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35141966,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-05T02:00:06.290Z","response_time":100,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","cargo-subcommand","rust"],"created_at":"2026-07-05T02:30:28.147Z","updated_at":"2026-07-05T02:30:29.335Z","avatar_url":"https://github.com/suradet-ps.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AgentForge-RS\n\n\u003e The official `cargo` subcommand to bootstrap AI-ready Rust projects with `AGENTS-RUST.md`.  \n\u003e One command. Zero configuration. Production-grade AI rules delivered instantly.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Rust](https://img.shields.io/badge/Rust-1.95%2B-orange)](https://www.rust-lang.org)\n[![Cargo CLI](https://img.shields.io/badge/Cargo-Subcommand-blue)]()\n\n## What is this?\n\n`agentforge-rs` provides a lightweight CLI tool (`cargo agentforge`) that places a battle-tested `AGENTS-RUST.md` baseline into your project root. This file acts as a **constitution for AI coding agents**, enforcing:\n\n- Strict safety \u0026 idiomatic Rust patterns\n- Mandatory `clippy`, `fmt`, `test`, and `doc` validation\n- Predictable, tiered refactoring workflows\n- A formal `[OVERRIDE §X]` system for project-specific exceptions\n\nStop manually copying rules. Stop guessing how your AI should behave. Just run `cargo agentforge` and start building.\n\n## Quick Start\n\n### 1. Install the CLI\n```bash\ncargo install --git https://github.com/suradet-ps/agentforge-rs cargo-agentforge\n```\n\n### 2. Use in Any Rust Project\n```bash\ncd your-rust-project\ncargo agentforge\n```\n\n✅ `AGENTS-RUST.md` is now in your project root. Your AI agent will automatically read and follow it.\n\n## How It Works\n\n| Step | Action |\n|------|--------|\n| `cargo agentforge` | Checks if `AGENTS-RUST.md` already exists |\n| Missing | Embeds the latest baseline template \u0026 writes it to root |\n| Exists | Skips installation \u0026 prints a reminder |\n| Update | Re-run `cargo install --git ... --force` to pull latest rules |\n\nBuilt with pure Rust. Zero dependencies. Compiled once, works everywhere.\n\n## What's Inside `AGENTS-RUST.md`?\n\nThe installed file contains **14 enforceable sections** covering:\n- `§0–2` Agent behavior, interaction protocols \u0026 golden rules\n- `§3–4` Mandatory checks, `Cargo.toml` \u0026 workspace standards\n- `§5–7` Ownership, error handling, async/tokio patterns\n- `§8–9` Testing hygiene \u0026 documentation standards\n- `§10–11` Security checklist \u0026 CI/release workflows\n- `§12–13` Refactoring workflow \u0026 anti-pattern table\n- `§14` Project Overrides system for safe rule exceptions\n\n[View the full `AGENTS-RUST.md` source](./templates/AGENTS-RUST.md)\n\n## The Override System (Built-In)\n\nReal projects need flexibility. Add exceptions directly in the generated file:\n```markdown\n## 14. Project Overrides\n[OVERRIDE §5.2] Use `anyhow` instead of `thiserror` for faster iteration\n[OVERRIDE §4.1] edition = \"2021\" (legacy dependency requirement)\n```\nAI agents read overrides at runtime and adjust behavior without breaking baseline compliance.\n\n## Maintenance \u0026 Updates\n\n```bash\n# Update the CLI to the latest version\ncargo install --git https://github.com/suradet-ps/agentforge-rs cargo-agentforge --force\n\n# Update the rules in an existing project\nrm AGENTS-RUST.md \u0026\u0026 cargo agentforge\n```\n\n## Contributing\n\nThis project is a living standard. We welcome:\n- Bug reports \u0026 AI edge-case discoveries\n- Rule refinements, anti-pattern additions, or workflow improvements\n- Translations or domain-specific templates (Tauri, Bevy, Embedded, WASM)\n\nOpen an issue or PR. Please reference the `§` section you're modifying.\n\n## License\n\nDistributed under the **MIT License**. See `LICENSE` for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuradet-ps%2Fagentforge-rs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuradet-ps%2Fagentforge-rs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuradet-ps%2Fagentforge-rs/lists"}