# 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 (X1–X2) 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.