AyCode.Core/.github/skills/protocol-audit/references/REPOS.md

7.5 KiB
Raw Blame History

Repos under protocol-audit

Scope note — workspace meta-tooling: This file is workspace-configuration, not framework code. It may list repos at any layer (including consumer products) because protocol-audit is a workspace-level cross-cutting tool. This is an intentional exception to the Framework-First Design Principle — see AyCode.Core/.github/copilot-instructions.md → Framework-First Design Principle → Exception for workspace meta-tooling. If AyCode.Core is extracted as a standalone framework, this file is replaced with the new workspace's layout.

Each row is one .github/copilot-instructions.md file that participates in the shared AI AGENT CORE PROTOCOL — either as Primary (full numbered-rule protocol) or Inherit (references the canonical host's protocol, minimal own content).

Canonical protocol host

AyCode.Core — this repo hosts the shared agent skills (.github/skills/), the Decision Log (.github/LLM_PROTOCOL_DECISIONS.md), and these registry files. All inherit files reference AyCode.Core. Cross-cutting invariants (X1X2) are skipped for the host itself (it does not cross-reference itself).

If the host designation is ever moved to a different repo, update this section AND the inherit-file substring checked by invariant I1 in SKILL.md.

Primary protocol files

These files contain the full numbered AI AGENT CORE PROTOCOL (Rules #1-5), @repo block, and Conventions. All structural, rule-content, and cross-reference invariants apply. The first row (marked ) is the canonical protocol host.

# Name Absolute path Layer Host
1 AyCode.Core H:\Applications\Aycode\Source\AyCode.Core framework (0)
2 AyCode.Blazor H:\Applications\Aycode\Source\AyCode.Blazor framework (1)
3 Mango.Nop Libraries H:\Applications\Mango\Source\NopCommerce.Common\4.70\Libraries shared libs (2)
4 FruitBank H:\Applications\Mango\Source\FruitBank product (3)
5 FruitBankHybridApp H:\Applications\Mango\Source\FruitBankHybridApp product (3)

Inherit protocol files

These files reference AyCode.Core's protocol via blockquote and do NOT repeat the numbered rules. Only the reduced invariant set applies (see "Invariants by type" below).

# Name Absolute path Layer Role
6 Mango.Nop.Core H:\Applications\Mango\Source\NopCommerce.Common\4.70\Libraries\Mango.Nop.Core framework (2) Domain framework for NopCommerce plugins
7 Nop.Plugin.Misc.AIPlugin H:\Applications\Mango\Source\NopCommerce.Common\4.70\Plugins\Nop.Plugin.Misc.AIPlugin consumer (3) FruitBank plugin source code
8 Mango.FruitBank H:\Applications\Mango\FruitBank host (4) nopCommerce deployment for FruitBank co.

The instruction file to audit for each is: <abs-path>\.github\copilot-instructions.md.

Expected own-dep-repos (for @repo block path validation)

Primary

Repo Expected deps (relative path from this repo's root)
AyCode.Core — (none)
AyCode.Blazor AyCode.Core: ../AyCode.Core
Libraries AyCode.Core: ../../../../../Aycode/Source/AyCode.Core
FruitBank AyCode.Core: ../../../Aycode/Source/AyCode.Core, Mango.Nop Libraries: ../NopCommerce.Common/4.70/Libraries
FruitBankHybridApp AyCode.Core: ../../../Aycode/Source/AyCode.Core, AyCode.Blazor: ../../../Aycode/Source/AyCode.Blazor, Mango.Nop Libraries: ../NopCommerce.Common/4.70/Libraries

Inherit

Repo Expected deps (relative path from this repo's root)
Mango.Nop.Core AyCode.Core: ../../../../../../Aycode/Source/AyCode.Core
Nop.Plugin.Misc.AIPlugin Mango.Nop.Core: ../../Libraries/Mango.Nop.Core, AyCode.Core: ../../../../../../Aycode/Source/AyCode.Core
Mango.FruitBank AyCode.Core: ../../Aycode/Source/AyCode.Core

Invariants by type

Primary files (1-5) — full invariant set per SKILL.md:

  • Rule numbering contiguous 1..N
  • Rule #2 contains CROSS-REPO HARD-GATE and PER-QUESTION DOC-FIRST
  • Rule #3 is STRICT NO-RE-READ POLICY (ANTI-LOOP) and contains "in context" definition (lossy compressions)
  • Rule #4 contains auto-detection triggers
  • Rule #5 contains broad scope wording (any file (code, documentation, configuration, memory, or otherwise))
  • strictly maintain rule 3 reference exists
  • ## Shared Agent Skills section with both skills listed
  • ## Protocol History section referencing AyCode.Core/.github/LLM_PROTOCOL_DECISIONS.md
  • @repo block has all 4 required fields, paths resolve to existing directories

Inherit files (6-8) — reduced invariant set:

  • References AyCode.Core's protocol via substring: follows the AI Agent Core Protocol defined in AyCode.Core
  • Has ## Shared Agent Skills section listing both skills (docs-discovery + protocol-audit)
  • Has ## Protocol History section referencing AyCode.Core/.github/LLM_PROTOCOL_DECISIONS.md
  • @repo block (if present) has all 4 required fields, paths resolve to existing directories
  • Numbered rules are NOT required (they are inherited from AyCode.Core)

Known issues

(No open issues. Previously tracked — Mango.Nop.Core path off-by-one and Mango.FruitBank purpose TBD — are resolved; see AyCode.Core/.github/LLM_PROTOCOL_DECISIONS.md for the fix history.)

Maintenance note

When modifying the repo set (add, remove, or relocate), update this table. SKILL.md remains stable because it reads this file at runtime.