Skip to content

Add agent-agnostic AI skill structure with Docs/ reference guides#41

Draft
amccall-mindera wants to merge 2 commits intomainfrom
task/harmonise-ai-agent-skills
Draft

Add agent-agnostic AI skill structure with Docs/ reference guides#41
amccall-mindera wants to merge 2 commits intomainfrom
task/harmonise-ai-agent-skills

Conversation

@amccall-mindera
Copy link
Copy Markdown

Summary

Introduces a fully tool-agnostic AI agent structure for the Flutter repo, consistent with Alfie-iOS and Alfie-Android.

Changes

New files

  • AGENTS.md — repo root source of truth (agents table, critical rules, pointers to Docs/)
  • .ai/agents/ — 7 standardised agents: feature-orchestrator, feature-developer, graphql-specialist, localization-specialist, security-specialist, spec-writer, testing-specialist
  • Docs/ — 8 reference guides extracted from copilot-instructions.md:
    • Architecture.md, Navigation.md, GraphQL.md, Localization.md
    • CodeStyle.md, Testing.md, Development.md, QuickReference.md

Modified

  • .github/copilot-instructions.md → slimmed to 5-line stub pointing to AGENTS.md

Why

Mirrors the structure established in Alfie-iOS (PR #62). All content is preserved — just reorganised so any AI tool (GitHub Copilot, Claude, Cursor, or any AGENTS.md-compatible tool) loads minimal context by default and reads detailed guides on-demand.

- Create AGENTS.md at repo root as tool-agnostic source of truth
- Create Docs/ with 8 reference guides extracted from copilot-instructions.md:
  Architecture.md, Navigation.md, GraphQL.md, Localization.md, CodeStyle.md,
  Testing.md, Development.md, QuickReference.md
- Add 7 standardised .ai/agents/ files:
  feature-orchestrator, feature-developer, graphql-specialist,
  localization-specialist, security-specialist, spec-writer, testing-specialist
- Slim .github/copilot-instructions.md to a 5-line stub referencing AGENTS.md
- Update all agent reference links to point to Docs/ files

Agents are now named and structured consistently with Alfie-iOS and Alfie-Android.
Agents located in .ai/agents/ for tool-agnostic compatibility (works with
GitHub Copilot, Claude, Cursor, and any AGENTS.md-compatible tool).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 1, 2026

LCOV of commit 7844a83 during CI #420

Summary coverage rate:
  source files: 129
  lines.......: 38.9% (835 of 2148 lines)
  functions...: no data found
  branches....: 43.8% (308 of 704 branches)
Message summary:
  51 ignore messages:
    inconsistent: 51

Files changed coverage rate: n/a

Full coverage report

@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 1, 2026

LCOV of commit 6b5900e during CI #428

Summary coverage rate:
  source files: 129
  lines.......: 38.9% (835 of 2148 lines)
  functions...: no data found
  branches....: 43.8% (308 of 704 branches)
Message summary:
  51 ignore messages:
    inconsistent: 51

Files changed coverage rate: n/a

Full coverage report

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants