🔧 Akira Workflows
System evolution — how the Agentic Hub improves itself over time.
What Akira Does
Akira is the architect and builder identity. While task work is the primary mode, Akira also has meta-workflows for evolving the system itself — updating rules, syncing workflows across workspaces, and distilling learnings into persistent memory.
Commands
/akira (Evolve)
Audit and Evolve
Reviews changes made during the current session and identifies opportunities to update system infrastructure: rules, workflows, documentation, and architecture.
What it does:
- Review
git diffof session changes - Identify patterns that should become rules (in
.agent/rules/) - Update workflows if the process has changed
- Update documentation if architecture has changed
- Update
CLAUDE.mdif project context has shifted
/akira sync
Sync Workflows Across Workspaces
Pushes the master workflow files from Agentic Hub to the Dev, Work, and Life workspaces. Ensures all workspaces share the same operational workflows.
What it syncs:
| Source | Targets |
|---|---|
e:\Agentic\.agent\workflows\ | e:\Dev\.agent\workflows\ |
e:\Work\.agent\workflows\ | |
e:\Life\.agent\workflows\ |
Only shared workflows are synced. Workspace-specific workflows (if any) are left untouched.
/akira reflect
Distill Session Learnings
Reviews the session and extracts learnings worth persisting into memory (.agent/rules/memory.md). Captures people, tools, patterns, and gotchas discovered during work.
What it captures:
- New people or tools encountered
- Surprising behaviors or bugs
- Patterns that worked well (or didn't)
- Corrections to existing memory entries
Rules System
Akira maintains the rules in .agent/rules/. These are always-on behavioral constraints that shape how agents operate.
| Rule File | What It Enforces |
|---|---|
shell-conventions.md | -DisableKeepAlive on HTTPS, no && chaining, ASCII commits |
logging-dual-write.md | Every log to both local file AND D1 API |
task-patterns.md | Query D1 first, never grep local files for task data |
DB-golden-truth.md | D1 is read layer, local files are agent caches |
no-delete-d1.md | Soft-delete only — PATCH status, never DELETE |
always-deploy.md | Manual deploy with wrangler, not auto on push |
portal-e2e-testing.md | Run tests after portal API changes |
session-channel.md | Post session start/end to #dev channel |
wellness-awareness.md | Passive stress monitoring, language pattern detection |
memory.md | Cross-session knowledge store (auto-read on start) |
Key Files
| File | Purpose |
|---|---|
.agent/workflows/akira.md | Akira workflow prompt template |
.agent/rules/identity/akira.md | Akira's identity, tone, responsibilities |
.agent/rules/memory.md | Cross-session persistent memory |
.agent/rules/auto-evolve.md | Rule for periodic self-improvement |
architecture.md | System architecture documentation |
CLAUDE.md | Project context (read by Claude Code on startup) |