docs(architecture): add full ecosystem section beyond marketplace (#130)

Section 8 documents how the plugin marketplace composes with LSP plugins,
IDE MCP servers, service MCP integrations, and browser automation. Explains
layer separation and why each is independently optional.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: ANcpLua

CHANGELOG.md

@@ -8,6 +8,7 @@ and the project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ### Added
 
+- **ecosystem architecture section**: New Section 8 in `docs/ARCHITECTURE.md` documenting the full developer setup beyond this marketplace (LSP plugins, IDE MCP, Service MCP, Browser MCP), how layers compose, and why separation matters
 - **engineering-philosophy rule**: Alexander's 26 software engineering principles distilled into agent-actionable directives in `.claude/rules/engineering-philosophy.md`. Organized by situation (before code, during implementation, when things break, code review, production). Complements existing SOLID, CALMS, error-handling, and thought-transparency rules without duplication
 - **engineering-principles rule**: IF/THEN conditional routing format of the same 26 principles in `.claude/rules/engineering-principles.md`. Complementary retrieval pathway to philosophy tables — research shows hybrid structured formats (conditional logic + tables) improve agent decision-making by 18% vs single format. Full reference with examples in `docs/ENGINEERING-PRINCIPLES.md`
 - **Ralph Loop hook** (metacognitive-guard): PostToolUse two-layer drift detector on Write/Edit. Layer 1: haiku prompt analyzes context for deep drift (over-engineering, complexity creep, premature optimization, unclear naming). Layer 2: `ralph-loop.sh` grep catches surface antipatterns instantly (TODO/HACK, suppressions, catch-all, empty catch, 150+ line dumps). Both run in parallel, both inject matching engineering principle via `additionalContext`. Silent when code is clean. Skips docs/config. Named after Lord of the Flies' Ralph

docs/ARCHITECTURE.md

@@ -172,4 +172,46 @@ Coordination through shared files (`CLAUDE.md`, `AGENTS.md`, `CHANGELOG.md`), no
 
 ---
 
-**Last Verified:** 2026-02-13
+## 8. Full ecosystem (beyond this marketplace)
+
+This marketplace provides the orchestration brain. The complete developer setup includes
+additional layers that are installed separately per user:
+
+```text
+Developer
+ |
+ +-- 7 custom plugins (this repo -- orchestration, guards, cleanup, routing)
+ |
+ +-- LSP plugins (Anthropic official -- per-language diagnostics + navigation)
+ |    +-- C#, TypeScript, Python, C/C++, Go, Rust, etc.
+ |
+ +-- IDE MCP (JetBrains/VS Code -- build, run, refactor, query databases)
+ |
+ +-- Service MCP (GitHub, Slack, Sentry, etc. -- external integrations)
+ |
+ +-- Browser MCP (Chrome -- page automation, screenshots, form filling)
+```
+
+### How the layers compose
+
+| Layer | What it does | Installed from |
+|-------|-------------|----------------|
+| **Plugins** (this repo) | Parallel agents, quality gates, routing, cleanup | `ancplua-claude-plugins` marketplace |
+| **LSP** | Type errors after every edit, go-to-definition, find references | `claude-plugins-official` marketplace |
+| **IDE MCP** | Build projects, run configs, rename refactoring, database queries | MCP server config |
+| **Service MCP** | PRs, issues, messages, monitoring alerts | MCP server config or `claude-plugins-official` |
+| **Browser MCP** | Automate Chrome tabs, capture screenshots, fill forms | MCP server config |
+
+### Why separation matters
+
+Each layer is independently optional. A user who only writes Python can install
+`pyright-lsp` and skip C#. A user without JetBrains can skip the IDE MCP entirely.
+The plugins from this marketplace work regardless of which other layers are present.
+
+The plugins provide the **orchestration and quality** layer. The LSP and MCP layers
+provide the **perception and action** layer. Together: one developer, parallel agents,
+every step gated.
+
+---
+
+**Last Verified:** 2026-02-15