Forge rough ideas into drift-proof execution contracts for AI coding agents. 6-step pipeline, 16 agents, 8 skills, lifecycle hooks, 5 tech presets.
Instructions file GitHub Copilot
Instructions for srnichols/plan-forge, covering instructions for copilot, architecture principles, core principles (non-negotiable), cost estimates and talking to forge-master.
Instructions file GitHub Copilot
Agent-Computer Interface (ACI) rules — how every forge MCP tool must shape its inputs and outputs so the calling agent can use it reliably. Auto-loads when editing tool definitions or capabilities.
Instructions file GitHub Copilot
AI Plan Hardening Runbook quick reference — auto-loads when editing plan files.
Instructions file GitHub Copilot
Core architecture principles — Architecture-First Approach, Separation of Concerns, TDD, Best Practices over Quick Wins. READ BEFORE any code changes.
Instructions file GitHub Copilot
Clean Code guardrails — function design, naming, commenting, and review checklist derived from the Phase 42 audit (Clean Code, Robert C. Martin).
Instructions file GitHub Copilot
Context management for AI agents — recognize context degradation, prioritize instructions, bridge sessions with memory.
Instructions file GitHub Copilot
Git workflow and commit conventions — conventional commits, push reminders, version-aware messaging.
Instructions file GitHub Copilot
Project Principles — auto-loads governing principles when docs/plans/PROJECT-PRINCIPLES.md exists.
Instructions file GitHub Copilot
Plan Forge release procedure — auto-loads when editing release-related files. Maintainer-only; NOT shipped to consuming projects.
Instructions file GitHub Copilot
Security rules for Plan Forge — input validation, command-injection avoidance, secret handling, and the "mutate user repo" contract. Auto-loads broadly because every file is a potential boundary.
Instructions file GitHub Copilot
Self-repair reporting — when and how to file meta-bugs against Plan Forge itself using forgemetabugfile.
Instructions file GitHub Copilot
Standard output templates for orchestration status updates, progress reports, blockers, completions, handoffs, and failure reports. Use these formats during plan execution, multi-agent runs, and autonomous operations.
Instructions file GitHub Copilot
Testing rules for Plan Forge — vitest patterns, fake-timers vs tolerance, mocking conventions, and how to read test output without hallucinating failures. Auto-loads when editing test files.
Instructions file GitHub Copilot
Azure Developer CLI (azd) patterns — azure.yaml structure, infra folder, tags, hooks, pipelines.
Instructions file GitHub Copilot
Bicep IaC patterns — file structure, naming, modules, parameters, outputs, linter, security.
Instructions file GitHub Copilot
Azure Cloud Adoption Framework (CAF) governance — management groups, naming, tagging, subscriptions, cost management, identity governance.
Instructions file GitHub Copilot
Azure IaC pipeline patterns — GitHub Actions, Azure DevOps, OIDC auth, deployment stages, rollback.
Instructions file GitHub Copilot
Azure Landing Zone baselines — identity, network, policy, management, security, tagging, subscription organization.
Instructions file GitHub Copilot
Azure naming conventions — Microsoft CAF abbreviations, constraints, uniqueness, tagging.
Instructions file GitHub Copilot
Azure Policy and Initiative compliance — definitions, assignment, compliance state, exemptions, remediation tasks.
Instructions file GitHub Copilot
PowerShell best practices for Azure IaC — Az module, script structure, Pester testing, PSScriptAnalyzer.
Instructions file GitHub Copilot
Terraform Azure patterns — file structure, providers, state, naming, security, testing.
Instructions file GitHub Copilot
Azure Well-Architected Framework (WAF) guardrails — Reliability, Security, Cost, Operational Excellence, Performance.
Instructions file GitHub Copilot
API patterns for .NET — REST conventions, ProblemDetails, pagination, versioning, error responses.