Skip to content

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

Draft
amccall-mindera wants to merge 1 commit intomainfrom
task/harmonise-ai-agent-skills
Draft

Add agent-agnostic AI skill structure with Docs/ reference guides#14
amccall-mindera wants to merge 1 commit intomainfrom
task/harmonise-ai-agent-skills

Conversation

@amccall-mindera
Copy link
Copy Markdown

Summary

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

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/ — 7 reference guides extracted from copilot-instructions.md:
    • Architecture.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 7 reference guides extracted from copilot-instructions.md:
  Architecture.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-Flutter.
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>
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.

1 participant