Template

Files

lmiranda 14425cfad1 fix: remove Wiki.js references from architecture docs

- Updated agent-workflow.spec.md to use Gitea Wiki instead of Wiki.js
- Updated component-map.spec.md to show Gitea (Issues + Wiki) as single service
- Changed GraphQL references to REST API (Gitea uses REST)
- Added Code Reviewer agent swimlane to agent-workflow diagram
- Added ARCHITECTURE NOTES sections to clarify current design

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-20 11:22:20 -05:00

5.1 KiB

Raw Blame History

Component Map - Draw.io Specification

Target File: docs/architecture/component-map.drawio

Purpose: Shows all plugins, MCP servers, hooks and their relationships.

NODES

Plugins (Blue - #4A90D9)

ID	Label	Type	Color	Position
projman	projman	rectangle	#4A90D9	top-center
projman-pmo	projman-pmo (planned)	rectangle	#4A90D9	top-right
project-hygiene	project-hygiene	rectangle	#4A90D9	top-left
claude-config	claude-config-maintainer	rectangle	#4A90D9	bottom-left
cmdb-assistant	cmdb-assistant	rectangle	#4A90D9	bottom-right

MCP Servers (Green - #7CB342)

MCP servers are bundled inside each plugin that needs them.

ID	Label	Type	Color	Position	Bundled In
gitea-mcp	Gitea MCP Server	rectangle	#7CB342	middle-left	projman
netbox-mcp	NetBox MCP Server	rectangle	#7CB342	middle-right	cmdb-assistant

External Systems (Gray - #9E9E9E)

ID	Label	Type	Color	Position
gitea-instance	Gitea\n(Issues + Wiki)	cylinder	#9E9E9E	bottom-left
netbox-instance	NetBox	cylinder	#9E9E9E	bottom-right

Configuration (Orange - #FF9800)

ID	Label	Type	Color	Position
system-config	System Config\n~/.config/claude/	rectangle	#FF9800	far-left
project-config	Project Config\n.env	rectangle	#FF9800	far-right

EDGES

Plugin to MCP Server Connections

From	To	Label	Style	Arrow
projman	gitea-mcp	bundled	solid	bidirectional
cmdb-assistant	netbox-mcp	bundled	solid	bidirectional

Plugin Dependencies

From	To	Label	Style	Arrow
projman-pmo	projman	depends on	dashed	forward

MCP Server to External System Connections

From	To	Label	Style	Arrow
gitea-mcp	gitea-instance	REST API	solid	forward
netbox-mcp	netbox-instance	REST API	solid	forward

Configuration Connections

From	To	Label	Style	Arrow
system-config	gitea-mcp	credentials	dashed	forward
system-config	netbox-mcp	credentials	dashed	forward
project-config	gitea-mcp	repo context	dashed	forward
project-config	netbox-mcp	site context	dashed	forward

GROUPS

ID	Label	Contains	Style
plugins-group	Plugins	projman, projman-pmo, project-hygiene, claude-config, cmdb-assistant	light blue border
external-group	External Services	gitea-instance, netbox-instance	light gray border
config-group	Configuration	system-config, project-config	light orange border

LAYOUT NOTES

+------------------------------------------------------------------+
|                         PLUGINS GROUP                             |
|  +----------------+  +----------------+  +-------------------+    |
|  | project-       |  |    projman     |  |   projman-pmo    |    |
|  | hygiene        |  |  [gitea-mcp]   |  |    (planned)      |    |
|  +----------------+  +-------+--------+  +-------------------+    |
|                              |                                    |
|  +----------------+  +-------------------+                        |
|  | claude-config  |  |  cmdb-assistant   |                        |
|  | -maintainer    |  |   [netbox-mcp]    |                        |
|  +----------------+  +--------+----------+                        |
+------------------------------------------------------------------+
                               |
                               v
+------------------------------------------------------------------+
|                    EXTERNAL SERVICES GROUP                        |
|  +-------------------+              +-------------------+         |
|  |      Gitea        |              |     NetBox        |         |
|  |  (Issues + Wiki)  |              |                   |         |
|  +-------------------+              +-------------------+         |
+------------------------------------------------------------------+

CONFIG GROUP (left side):           CONFIG GROUP (right side):
+-------------------+               +-------------------+
| System Config     |               | Project Config    |
| ~/.config/claude/ |               | .env              |
+-------------------+               +-------------------+

COLOR LEGEND

Color	Hex	Meaning
Blue	#4A90D9	Plugins
Green	#7CB342	MCP Servers (bundled in plugins)
Gray	#9E9E9E	External Systems
Orange	#FF9800	Configuration

ARCHITECTURE NOTES

MCP servers are bundled inside plugins (not shared at root)
Gitea provides both issue tracking AND wiki (lessons learned)
No separate Wiki.js - all wiki functionality uses Gitea Wiki
Each plugin is self-contained for Claude Code caching

5.1 KiB Raw Blame History