ALBA v1.0.0 — Your routine-driven AI companion

What is ALBA?

ALBA transforms Claude Code into a personal AI agent with persistent memory, automated workflows, and self-improving behavior — tailored to any role.

10-minute interactive setup. Zero dependencies. Pure markdown.

Highlights

Core System

• Interactive /setup — Answer 7 questions, get a complete personalized agent
• 9 built-in skills — /start, /end, /status, /research, /weekly-review, /extend, /reflect, /create-skill
• 6 automated hooks — Bash safety, error logging, session management, context preservation
• 3-tier memory — State (hot), Knowledge (warm), Projects (cold) — all git-tracked markdown

Architecture

• Progressive disclosure — CLAUDE.md stays under 200 lines, details lazy-load
• Skills 2.0 — YAML frontmatter with context: fork/inline and allowed-tools
• Auto-configured hooks — /setup generates settings.json automatically

Compatibility

• Claude Code v2.1.71+ — /loop integration for periodic monitoring
• Auto-memory — Coexists with Claude Code's built-in memory system
• Cross-platform — macOS and Linux hook scripts

Examples

5 complete, working setups included:

• Developer, Project Manager, Content Creator, Researcher, Founder

Quick Start

git clone https://github.com/onurpolat05/ALBA.git my-agent
cd my-agent
claude
# Then type: /setup

What's Next

• Visual demo content (Remotion-based)
• Skill marketplace concept
• More role examples
• Community skill sharing

---

ALBA — Consistent. Independent. Always learning.