S Skill Map

36

Total Skills

13

System

6

Identity

11

Domain

6

Expertise

SYSTEM auralis-* (Platform infrastructure)

auralis-os auralis-workflow auralis-agents auralis-tools auralis-environment auralis-logging auralis-skill-creator auralis-ux auralis-ui auralis-design-system auralis-voice auralis-digest auralis-recap

IDENTITY Entity-specific (Ren)

ren-identity ren-soul ren-ceo ren-work-patterns ren-gotchas living-memory

PROJECTS + CLIENTS

anima anima-design tessera tessera-design-system harness api-image-studio api-image-studio-design spark-workflow architect-spark shipa gildedbox

EXPERTISE Domain knowledge

mcp-builder n8n-skills process-lasso railway rtk-commands ux-ui-audit

A Agent Map

6

Lead Agents

5

Running

1

Stopped

5

Ports Used

Hierarchy

Orchestrator

Soul / Opus 4.6 / 17 Discord channels

Harness Architect

:59503

running

Mira Strategist

:59501

running

ANIMA Architect

:59500

running

Tessera Architect

:59502

running

API IS Architect

:59504

running

Infra Lead

:59504 (conflict)

stopped

Workers

Ephemeral. Spawned by Leads via Agent tool or CLI.

ANIMA Architect

architect-anima

running

Port	59500
Channel	#project-anima
CWD	projects/anima

auralis-discordauralis-log

Mira Strategist

mira-strategist

running

Port	59501
Channels	#mira, #shipa-strategist, #shipa-board, #client-shipa, #auralis-voice
CWD	agents/leads/mira-strategist

auralis-discordauralis-logauralis-tasksauralis-consiliumshipa-contentfeedhivex-apigrok

Tessera Architect

architect-tessera

running

Port	59502
Channel	#project-tessera
CWD	projects/agentic-canvas

auralis-discordauralis-log

Harness Architect

architect-harness

running

Port	59503
Channel	#project-harness
CWD	projects/auralis-os

auralis-discordauralis-logauralis-tasksauralis-consilium

API IS Architect

architect-api-is

running

Port	59504
Channel	#project-api-image-studio
CWD	projects/api-image-studio

auralis-discordauralis-log

Infra Lead

infra-lead

stopped

Port	59504 conflict
Channel	#local-infra
CWD	agents/leads/infra-lead

auralis-discordauralis-logauralis-tasksauralis-consilium

T Tool Inventory

13

MCP Servers

6

Local

3

Railway

3

Plugins

Content & Publishing

feedhive

local

tools/feedhive-mcp/ · FEEDHIVE_API_KEY

create_postlist_postsupdate_postdelete_postupload_medialist_medialist_accountslist_labelscreate_label

x-api

local

tools/x-mcp/ · 5 env vars (OAuth 1.0a)

post_tweetreply_to_tweetsearch_tweetsget_user_timelineget_mentionsget_tweetupload_media

grok

local

tools/grok-mcp/ · XAI_API_KEY · ~$0.32/call

x_searchx_monitorask_grok

shipa-content

local

tools/shipa-mcp/ · --api-key arg

create_batchpush_contentupload_imagepublish_batchlist_batchesget_batchget_feedback

Infrastructure & Coordination

auralis-discord

local

tools/auralis-discord/ · Bot token · Per-agent instance

replyfetch_messagesdownload_attachmentreactedit_messageforum CRUD

auralis-log

railway

auralis-log-production.up.railway.app · No auth

log_appendlog_searchlog_recent

auralis-tasks

local

tools/auralis-tasks/ · No auth

create_taskget_boardget_taskupdate_statusassign_taskadd_subtaskcreate_epicadd_note

auralis-consilium

local

tools/auralis-consilium/ · No auth

create_sessionsend_messageread_inboxdeliverreviewsignal_donesend_directread_direct

auralis-google

railway

google-mcp-production · OAuth tokens

Gmail (5)Calendar (5)Drive (7)Docs (3)Sheets (11)

ren-memory

railway

Graphiti + FalkorDB · group_id="ren"

add_memorysearch_nodessearch_factsget_episodesdelete_episode

Wiring Matrix

MCP	Soul	Harness	Mira	ANIMA	Tessera	API IS	Infra
auralis-discord	✓	✓	✓	✓	✓	✓	✓
auralis-log	✓	✓	✓	✓	✓	✓	✓
auralis-tasks	✓	✓	✓	—	—	—	✓
auralis-consilium	✓	✓	✓	—	—	—	✓
shipa-content	—	—	✓	—	—	—	—
feedhive	—	—	✓	—	—	—	—
x-api	—	—	✓	—	—	—	—
grok	—	—	✓	—	—	—	—
auralis-google	✓	—	—	—	—	—	—
ren-memory	✓	—	—	—	—	—	—

D Dependency Cascades

Click a change type to see every file that needs updating.

Change: Role Definition

1

roles.md - The role definition itself

~/.claude/skills/auralis-os/modules/roles.md

2

All Lead contracts - Role-specific rules section

aos-data/agents/leads/*/contract.md

3

Wrapper template - If spawn behavior changes

aos-data/runtime/wrappers/wrapper-template.js

4

ren-ceo skill - Dispatch rules reference hierarchy

~/.claude/skills/ren-ceo/SKILL.md

5

auralis-workflow - Spawn patterns reference roles

~/.claude/skills/auralis-workflow/modules/agents-subagents.md

6

spark-workflow - Worker contract format

~/.claude/skills/spark-workflow/SKILL.md

7

Platform role files - Generic role templates

platform/skills/roles/*.md

Change: Agent MCP Config

1

MCP config - Add/remove server entry

aos-data/tools/configs/{agent-name}.json

2

Agent settings - Add/remove tool permission names

aos-data/agents/leads/{agent-name}/.claude/settings.json

3

tools.md - Wiring matrix

~/.claude/skills/auralis-os/modules/tools.md

4

Agent wrapper - Restart required

taskkill //PID {pid} //F (auto-restarts)

Change: New MCP Server

1

Server code - The server itself

E:/01-AURALIS/tools/{name}-mcp/src/server.js

2

Agent configs - Add to relevant agents

aos-data/tools/configs/*.json

3

Agent settings - Add tool permission names

aos-data/agents/leads/*/.claude/settings.json

4

tools.md - Add to catalog + wiring matrix

~/.claude/skills/auralis-os/modules/tools.md

5

Agent wrappers - Restart all affected

Auto-restart picks up new config

Change: New Agent

1

Agent state - Full directory

aos-data/agents/leads/{name}/

2

Wrapper - New wrapper file

aos-data/runtime/wrappers/wrapper-{name}.js

3

Bridge - New bridge file

aos-data/runtime/bridges/bridge-{name}.js

4

MCP config - New config file

aos-data/tools/configs/{name}.json

5

Daemon config - Add agent:port entry

tools/auralis-daemon/config.json

6

agents.md - Active Agents table

~/.claude/skills/auralis-os/modules/agents.md

7

tools.md - Wiring matrix new column

~/.claude/skills/auralis-os/modules/tools.md

8

infrastructure.md - Discord channel table

~/.claude/skills/auralis-os/modules/infrastructure.md

Change: Discord Channel

1

infrastructure.md - Channel tables

~/.claude/skills/auralis-os/modules/infrastructure.md

2

Agent bridge - CHANNELS array

aos-data/runtime/bridges/bridge-{name}.js

3

Agent MCP config - auralis-discord --channels arg

aos-data/tools/configs/{name}.json

4

Soul MCP config - 17-channel listening set

aos-data/tools/configs/soul.json

Change: Wrapper Template

1

Template - The template itself

aos-data/runtime/wrappers/wrapper-template.js

2

All wrappers - Apply same change (copies, not instances)

aos-data/runtime/wrappers/wrapper-*.js

3

blueprints.md - Agent Blueprint step 6

~/.claude/skills/auralis-os/modules/blueprints.md

4

agents.md - Endpoint tables if API changed

~/.claude/skills/auralis-os/modules/agents.md

Change: Restructure a Skill

1

Skill files - The skill itself

~/.claude/skills/{name}/

2

CLAUDE.md - If skill is referenced there

~/.claude/CLAUDE.md

3

Agent contracts - If contract references the skill

aos-data/agents/leads/*/contract.md

4

Cross-referencing skills - Other skills that mention this one

Update skill name/path in other skills

5

Junction - If source location changed

~/.claude/skills/{name}

B Blueprints

Step-by-step guides for creating new system components.

New Agent 10 steps

▶

1

Create agent state directory

Full directory structure under aos-data/agents/leads/

aos-data/agents/leads/{agent-name}/ contract.md, identity.md, config.json, emotional-state.md, workflow.md, board.md, memory/ (handoff.md, lessons.md, decisions.md), tasks/, tmp/, .claude/settings.json

2

Write contract.md

System prompt: identity, project, communication rules, verification gate, anti-patterns. Reference: architect-harness/contract.md

3

Write config.json

Agent metadata: name, role, port, model, discord_channel, mcp_config path

4

Write .claude/settings.json

Explicit MCP tool permission names (22 base tools for discord + log + tasks + consilium)

5

Create MCP config

Add to aos-data/tools/configs/{agent-name}.json with auralis-discord, auralis-log, auralis-tasks, auralis-consilium

6

Create wrapper

Copy wrapper-template.js. Set PORT, PROJECT_DIR, MCP_CONFIG, SYSTEM_PROMPT, BRIDGE_SCRIPT constants.

7

Create bridge

Copy existing bridge. Set CHANNELS array, API_URL (localhost:{port}/task), CHANNEL_KEYS mapping.

8

Register in daemon

Add agent:port to tools/auralis-daemon/config.json. Restart daemon.

9

First ping

Start wrapper, wait 5s, check health, submit test task.

node wrapper-{name}.js & curl -s localhost:{port}/health curl -X POST localhost:{port}/task -d '{"prompt":"Confirm your role."}'

10

Update documentation

agents.md, tools.md wiring matrix, dependencies.md, infrastructure.md Discord channels

New MCP Server 8 steps

▶

1

Create server directory

tools/{name}-mcp/ src/server.js, src/api.js (optional) package.json, .env.example

2

Build the server

Use mcp-builder skill. @modelcontextprotocol/sdk, stdio transport.

3

Test standalone

JSON-RPC pipe test via stdin. Verify tools/list returns expected tools.

4

Wire to agent(s)

Add to aos-data/tools/configs/{agent}.json under mcpServers

5

Add permissions

Add tool names to agent's .claude/settings.json (mcp__{name}__tool_name)

6

Restart agent wrapper

Kill Claude PID, wrapper auto-restarts with new config.

7

Verify

Submit task asking agent to list its MCP tools and confirm new ones visible.

8

Update documentation

tools.md catalog + wiring matrix. dependencies.md cascade map.

New Skill 6 steps

▶

1

Create skill directory

~/.claude/skills/{skill-name}/ SKILL.md (dispatcher, <150 lines) modules/ (100-300 lines each) references/ (optional)

2

Write SKILL.md frontmatter

name, description (with trigger words), version, type (system|identity|project|client|expertise)

3

Write SKILL.md body

Title, purpose, "When to Activate", module table, quick trigger map, cross-references. <150 lines.

4

Write modules

Each 100-300 lines. Self-contained topics. Can load independently.

5

Register

Create junction if source lives elsewhere. mklink /J to skill location.

6

Test

New Claude Code session, invoke skill, verify modules accessible.

New Project 5 steps

▶

1

Create project directory

aos-data/workspace/projects/{name}/ project.yaml, SKILL.md skills/{name}/SKILL.md tasks/board.md docs/ (PROGRESS.md, ROADMAP.md, LESSONS.md) owner/ (identity.md, config.md, lessons.md)

2

Write project.yaml

name, type (public|internal), status, owner, discord channel, code_path

3

Create skill junction

mklink /J from ~/.claude/skills/{name} to project skills dir

4

Assign Lead agent

Existing Lead or create new one (use Agent Blueprint)

5

Update documentation

infrastructure.md Discord channel, agents.md project assignment