Add AI agent framework from AgentFactory

[Copilot]

Plan: Add AI agent framework from AgentFactory

• Understand the request - integrate AgentFactory's agent definitions into template
• Create .github/agents/ directory structure
• Copy agent definition files from AgentFactory (7 agents)
• Add agents.yaml configuration file
• Add agents.md documentation file
• Update README.md with agent information
• Fix inconsistencies from code review
• Revert unapproved documentation changes
• Fix references to non-existent schema and configuration
  • Removed references to schema.spec_fields in Architect.md and ChatGPT.md
  • Removed references to quality gates in agents.yaml in Skeptic.md
  • Removed references to handoff_requirements in agents.yaml in ProjectManager.md
  • Removed references to minimum outputs in agents.yaml in ChatGPT.md
  • Made all references self-contained within the agent specifications

Summary

Successfully integrated the AI agent framework from AgentFactory and addressed all review feedback.

Changes Made:

Agent Specification Fixes:

• Architect.md: Replaced schema.spec_fields references with explicit description of required spec sections
• ChatGPT.md: Updated to reference spec structure directly and changed minimum outputs reference to point to the agent's own Operating Procedure
• Skeptic.md: Removed references to non-existent quality gates in agents.yaml, made quality gates explicit in the spec
• ProjectManager.md: Replaced reference to non-existent handoff_requirements in agents.yaml with self-referential definition

All agent specifications are now self-contained and don't reference configuration that doesn't exist.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[alexanderholman]

@copilot instead, I want to add features introduced in the world of AI agents and use the implementation in github.com/alexanderholman/AgentFactory or however you recommend to be compatible with copilot. Use github.com/alexanderholman/AgentFactory/agents/* and related files for your own initial instructions.

[Copilot]

@copilot instead, I want to add features introduced in the world of AI agents and use the implementation in github.com/alexanderholman/AgentFactory or however you recommend to be compatible with copil...

Done! I've integrated the AI agent framework from AgentFactory into this template. The implementation includes:

7 Agent Definitions in .github/agents/:

• Architect (spec authoring & design)
• Builder (implementation)
• Skeptic (adversarial review)
• Editor (clarity improvements)
• Project Manager (coordination)
• Citation Officer (evidence auditing)
• ChatGPT (general-purpose)

Configuration & Documentation:

• agents.yaml - agent metadata and validation rules
• agents.md - usage guide and conventions
• Updated README.md with agent section

The agents are compatible with GitHub Copilot and can be referenced in code comments, issues, PRs, and Copilot Chat. All agent files follow a consistent structure with operating procedures, success criteria, and standard response formats.

Commits: 113f621 (fixes), e695582 (initial)

[alexanderholman]

@copilot Unapproved files, I dont think they need changing.

[Copilot]

Pull request overview

This PR backports the AgentFactory AI agent framework and improved documentation patterns into the base template so future projects can use structured Copilot-compatible agents out of the box. It adds a full set of agent specifications, central configuration, and clearer onboarding/install docs tailored to GitHub template workflows.

Changes:

• Introduced an AI agent framework (Architect, Builder, Skeptic, Editor, Project Manager, Citation Officer, ChatGPT) with detailed role specs under .github/agents/ and a central agents.yaml registry.
• Added agents.md and README updates documenting how to use these agents with GitHub Copilot, including tagging conventions and usage patterns.
• Refined template documentation (INSTALL, AUTHORS, CONTRIBUTORS, ACKNOWLEDGMENTS, CHANGELOG) to use concrete examples and cleaner placeholders for new projects.

Reviewed changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
agents.yaml	Defines agent metadata, tags, required headings, and validation rules that underpin the AI agent framework.
agents.md	Documents the agent structure, rules, roles, and Copilot usage patterns, serving as the main guide for the framework.
README.md	Adds a concise “AI Agents (GitHub Copilot)” section linking to agent docs and definitions.
INSTALL.md	Replaces generic package instructions with GitHub template-based setup, update, and removal workflows.
CONTRIBUTORS.md	Converts the contributor example line into a commented placeholder plus explanatory comment for a cleaner default.
CHANGELOG.md	Replaces placeholder changelog entry with a structured v1.0.0 example release section.
AUTHORS.md	Provides a concrete example core team entry with an actual author format.
ACKNOWLEDGMENTS.md	Switches the acknowledgments example to commented placeholders with a “none currently” note.
.github/agents/Architect.md	Adds the Architect agent spec covering spec authoring, constraints, and testable acceptance criteria.
.github/agents/Builder.md	Adds the Builder agent spec for turning specs into runnable/usable artifacts under flat-file constraints.
.github/agents/ChatGPT.md	Adds the ChatGPT generalist execution agent spec describing end-to-end workflow and tagging.
.github/agents/CitationOfficer.md	Adds the Citation Officer agent spec for evidence auditing and claim→evidence mapping.
.github/agents/Editor.md	Adds the Editor agent spec for clarity, structure, and tag enforcement without changing intent.
.github/agents/ProjectManager.md	Adds the Project Manager agent spec for orchestration, logs, and handoff packets.
.github/agents/Skeptic.md	Adds the Skeptic agent spec for adversarial review, counterexamples, and quality gate checks.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

@copilot Unapproved files, I dont think they need changing.

Reverted the documentation changes (ACKNOWLEDGMENTS, AUTHORS, CHANGELOG, CONTRIBUTORS, INSTALL) back to their original template format. The PR now only includes the AI agent framework files and the README update as requested.

Changed files remaining:

• .github/agents/*.md (7 agent definitions)
• agents.yaml (configuration)
• agents.md (documentation)
• README.md (AI Agents section only)

Commit: b35a4dd