Skip to content

Latest commit

 

History

History
73 lines (59 loc) · 7.29 KB

File metadata and controls

73 lines (59 loc) · 7.29 KB

Acknowledgments

This project was shaped by ideas, patterns, and prior art from many sources across the community. We want to recognize the projects, articles, and resources that influenced the design and direction of the DevSquad Copilot framework.

Repositories

Repository Influence
microsoft/hve-core Patterns for structuring AI-assisted development workflows
github/spec-kit Spec-driven development approach and tooling conventions
bradygaster/squad Agent coordination and team-oriented development model
mgechev/skills-best-practices Best practices for authoring GitHub Copilot skills
bmad-code-org/BMAD-METHOD Agent-driven development methodology and orchestration patterns
github/awesome-copilot Curated collection of GitHub Copilot resources and ecosystem references
walkinglabs/awesome-harness-engineering Curated harness engineering resources covering context management, evals, safe autonomy, and agent runtime design that informed enhancements to pattern anchoring, context backpressure, spec conformance verification, and failure capture

Research and Papers

Reference Influence
Cognitive Engagement in AI-Assisted Software Development (ACM) Evidence supporting the Socratic AI approach in ADR-0005
How AI Assistance Affects Coding Skills (Anthropic) Research on skill formation that shaped the intentional AI and delivery guardrails design
How AI Impacts Skill Formation Cognitive-engagement concerns with AI coding, cited in delivery guardrails

Articles and Blog Posts

Article Influence
Shell tricks that actually make life easier by Hofstede Shell scripting patterns used in hooks and automation
Bringing work context to your code in GitHub Copilot (Microsoft Developer Blog) Work IQ MCP context integration approach
The anatomy of a perfect pull request (opensource.com) PR review quality practices in coding guidelines
Clever code considered harmful (pcloadletter.dev) Readability-first philosophy in coding guidelines
The One True Way Fallacy (Code Rancher) Avoiding dogmatic single-paradigm thinking in coding guidelines
A practical guide to AI-assisted development by lpains Practical guidance on AI-assisted development workflows
AI fatigue is real by Siddhant Khare Perspectives on sustainable AI-assisted development and developer experience
How I estimate work by Sean Goedecke Work estimation approach that informed complexity analysis
Chesterton's Fence: A Lesson in Thinking (Farnam Street) Principle adopted in code review: understand why code exists before recommending removal
Compatibility is a Feature by Yusuf Aytas Mixed-version coexistence, rollback-against-state, and boundary-drift thinking that shaped the Compatibility and Transition section in feature specs
Harness Engineering by Martin Fowler Feedforward/feedback taxonomy for coding agent controls that shaped the harness-learnings skill and hook output contract
Harness Engineering: Leveraging Codex in an Agent-First World (OpenAI) Steering loop and layered architecture enforcement patterns that informed the two-tier learning mechanism in ADR-0013
The Architecture of Intent by Marcel Aldecoa Discipline for agent-class governance: behavioral envelope on agents, composition declarations on coordinators, fix-at-the-upstream-artifact failure routing, and cost commitments on AI-capability specs. Selectively adopted in ADR-0014, with parts of the source vocabulary (custom frontmatter scalars, Reversibility tier, Pattern A/B/C/D/E taxonomy, seven-category failure taxonomy) deliberately left out.

Design Patterns and Standards

Reference Influence
Mediator Pattern (Refactoring Guru) Basis for the conductor/orchestrator architecture in ADR-0001
Conventional Commits Commit message standard adopted in git-commit skill and coding guidelines
How to Write a Git Commit Message by Chris Beams Commit message guidance in coding guidelines
Keep a Changelog Changelog format standard
Semantic Versioning Versioning strategy for the framework
Logging Sucks Logging guidance referenced in coding guidelines
contributing.md Basis for the contributing guide template

Platform Documentation

The following official documentation informed the framework's extensibility model:

Reference Influence
Custom Agents (VS Code Docs) Agent authoring model and conventions
Subagents (VS Code Docs) Sub-agent coordination and nesting patterns
Create Skills (GitHub Docs) Skill authoring model
Path-Specific Custom Instructions (GitHub Docs) Instruction scoping and activation model
Use Hooks (GitHub Docs) Hook authoring model
Draw.io MCP Server (draw.io Blog) MCP-based diagramming integration
Get the best results from the coding agent (GitHub Docs) Coding agent best practices that shaped agent and skill design

Talks

Talk Influence
Visualising software architecture with the C4 model by Simon Brown (Agile on the Beach 2019) Architecture visualization approach that influenced the diagram-design skill and documentation structure