Instruction file imported from json-everything/json-everything-learn (.github/instructions/architecture.instructions.md). Copyright stays with the author.

Architecture Instructions

Name: architecture
Author: json-everything

This repository is a Blazor WebAssembly interactive learning site for JSON tooling libraries.

Solution Structure

LearnJsonEverything/ — Main Blazor WASM application (pages, services, shared components, lesson data).
LearnJsonEverything.Template/ — Shared interface project defining ILessonRunner<T>, consumed by both the app and user lesson solutions.
LearnJsonEverything.Tests/ — NUnit test project that validates all provided lesson solutions.
LearnJsonEverything.LessonEditor/ — WPF desktop tool for authoring lesson JSON files.
Lesson data (JSON files) lives in LearnJsonEverything/wwwroot/data/lessons/.

Project Organization

Keep UI concerns (pages, components) in LearnJsonEverything/Pages/ and LearnJsonEverything/Shared/.
Keep non-UI logic in LearnJsonEverything/Services/.
Keep lesson host implementations in LearnJsonEverything/Services/Hosts/.
The LearnJsonEverything.Template/ project must stay minimal — it defines the base interface for user-submitted code.
Do not add dependencies to LearnJsonEverything.Template/; it must remain lightweight.

Target Frameworks

All projects target net10.0.
Do not change target frameworks unless explicitly requested.

Dependency Direction

LearnJsonEverything references LearnJsonEverything.Template.
LearnJsonEverything.Tests references LearnJsonEverything.
LearnJsonEverything.LessonEditor is a standalone tool; do not introduce cross-references with the main app.
Keep external dependencies minimal and justified.

Behavior Changes

Any behavioral change should include a corresponding update to affected lesson JSON or a new test case.
Avoid broad refactors when a local fix is sufficient.

{ "ocm": "1", "id": "json-everything-json-everything-learn-architecture-instructions", "kind": "skill", "name": "architecture", "description": "This repository is a Blazor WebAssembly interactive learning site for JSON tooling libraries.", "publisher": "json-everything", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-instructions" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "This repository is a Blazor WebAssembly interactive learning site for JSON tooling libraries." ], "primary": false, "metadata": { "source": { "provider": "github-instructions", "repository": "https://github.com/json-everything/json-everything-learn", "path": ".github/instructions/architecture.instructions.md", "ref": "7f943d9bceba32ae11ee28c5657037c3ed3859ef", "url": "https://github.com/json-everything/json-everything-learn/blob/7f943d9bceba32ae11ee28c5657037c3ed3859ef/.github/instructions/architecture.instructions.md", "key": "json-everything/json-everything-learn/.github/instructions/architecture.instructions.md" }, "applies_to": "*.cs,*.csproj" }, "instructions": "# Architecture Instructions\n\nThis repository is a Blazor WebAssembly interactive learning site for JSON tooling libraries.\n\n## Solution Structure\n\n- `LearnJsonEverything/` — Main Blazor WASM application (pages, services, shared components, lesson data).\n- `LearnJsonEverything.Template/` — Shared interface project defining `ILessonRunner<T>`, consumed by both the app and user lesson solutions.\n- `LearnJsonEverything.Tests/` — NUnit test project that validates all provided lesson solutions.\n- `LearnJsonEverything.LessonEditor/` — WPF desktop tool for authoring lesson JSON files.\n- Lesson data (J", "cost": { "context_tokens": 441 } }

architecture

About

Architecture Instructions

Solution Structure

Project Organization

Target Frameworks

Dependency Direction

Behavior Changes

Use it

Manifest

Reviews