How firetruck666/project-forge works
project-forge is a reusable, host-discovered skill that guides an AI or user through standardizing a supplied project. The documented workflow starts with read-only inspection, uses the resulting facts and reference criteria to decide what applies, then performs selected version-control, remote, documentation, and publishing work; document generation and delivery review provide internal support. Major capability branches are included from the README, although their detailed execution is not all visible in the sampled source. The graph reflects documented responsibilities and sampled script calls, not an inspected end-to-end runtime.
Main entry points: SKILL.md Workflow entry · publish.md Publishing guide · compose-agents.mjs AGENTS generator · survey.mjs Read-only survey
Components 26
Skill workflow
- Workflow entry
SKILL.md
Project inspection
- Read-only survey
scripts/survey.mjs
Standards guidance
- Survey criteria
references/survey.md - Version control
references/version-control.md - Remote GitHub
references/remote-github.md - Documentation set
references/docs-set.md - Publishing guide
references/publish.md - npm publishing
references/publish-npm.md - Python publishing
references/publish-python.md - Go publishing
references/publish-go.md - Rust publishing
references/publish-rust.md - Plugin projects
references/plugin-project.md - Plugin ecosystem guides
references/plugins
Project setup
- AGENTS generator
scripts/compose-agents.mjs - AGENTS templates
templates/agents-project.md - Instruction kernel
templates/agents-kernel.md - Delivery review
scripts/review.mjs
Publishing
- Release-note draft
scripts/draft-release-notes.mjs - Release-note writer
scripts/release-notes.mjs
Other components
- User / AI host
- Target project
- GitHub
- npm registry
- Python registry
- Go module index
- Rust registry
Connections 34
- User / AI host → Workflow entry: requests work
- Workflow entry → Read-only survey: starts read-only survey
- Read-only survey → Target project: reads project
- Read-only survey → User / AI host: reports facts
- Workflow entry → Survey criteria: consults criteria
- Workflow entry → Version control: guides version setup
- Workflow entry → Remote GitHub: guides remote setup
- Workflow entry → Documentation set: guides documentation
- Workflow entry → Publishing guide: guides publishing
- Publishing guide → npm publishing: selects ecosystem guide
- Publishing guide → Python publishing: selects ecosystem guide
- Publishing guide → Go publishing: selects ecosystem guide
- Publishing guide → Rust publishing: selects ecosystem guide
- Workflow entry → Plugin projects: handles plugin projects
- Plugin projects → Plugin ecosystem guides: consults ecosystem guide
- Workflow entry → AGENTS generator: invokes when needed
- AGENTS generator → Read-only survey: surveys target
- AGENTS generator → AGENTS templates: uses skeleton
- AGENTS generator → Instruction kernel: injects kernel
- AGENTS generator → Target project: writes AGENTS.md
- Workflow entry → Delivery review: checks delivery
- Delivery review → Read-only survey: surveys target
- Delivery review → Target project: reads project files
- Workflow entry → Release-note draft: drafts release notes
- Release-note draft → Target project: reads Git history
- Release-note draft → GitHub: resolves remote
- Release-note draft → Target project: writes draft file
- Workflow entry → Release-note writer: writes release notes
- Release-note writer → Target project: reads notes file
- Release-note writer → GitHub: creates or updates release
- npm publishing → npm registry: publishes package
- Python publishing → Python registry: publishes package
- Go publishing → Go module index: publishes module
- Rust publishing → Rust registry: publishes crate