Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 2 additions & 4 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -25,9 +25,7 @@ ai-stuff/_shared/config/.clusters.json
ai-stuff/claude/skills/add-recipe/*.original*
ai-stuff/claude/skills/**/SKILL.original.md

# Private work-specific traefik migration agents/skills/config
# Private work-specific traefik migration config. The skill, traefik-dev and traefik-recon moved into
# k8s-gitops-platform-apps on 2026-08-12; only the personal Obsidian layer stays here.
ai-stuff/_shared/config/traefik-epic.md
ai-stuff/agents/traefik-dev.md
ai-stuff/agents/traefik-recon.md
ai-stuff/agents/traefik-vault.md
ai-stuff/skills/traefik/
3 changes: 3 additions & 0 deletions .zshrc
Original file line number Diff line number Diff line change
Expand Up @@ -224,3 +224,6 @@ export BASH_MAX_OUTPUT_LENGTH=15000

# Added by Antigravity CLI installer
export PATH="/Users/denizgokcin/.local/bin:$PATH"

# opencode
export PATH=/Users/denizgokcin/.opencode/bin:$PATH
32 changes: 24 additions & 8 deletions ai-stuff/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,11 +17,14 @@ installation. No per-tool transformation, no drift.
ai-stuff/
├── skills/ # ⭐ single source of truth — universal Agent Skills
│ ├── _shared -> ../_shared # makes relative ../_shared/... refs resolve
│ ├── commit/SKILL.md
│ ├── daily-recap/SKILL.md + scripts/
│ ├── vault-capture/SKILL.md + references/
│ ├── slackify/
│ │ ├── SKILL.md # frontmatter drives Claude Code
│ │ └── agents/openai.yaml # picker metadata + policy for Codex
│ ├── daily-recap/SKILL.md + agents/ + scripts/
│ ├── vault-capture/SKILL.md + agents/ + references/
│ ├── .archived/ # retired skills (never installed)
│ └── ...
├── invocation.md # user- vs model-invoked rules, Skill-tool phrasing, openai.yaml schema
├── _shared/ # personas, configs, templates referenced by skills+agents
│ ├── personas/ # gitboi, jira-girl, mega-dev, ...
│ ├── config/ # git-config, jira-config, .clusters.json, ...
Expand All @@ -48,7 +51,9 @@ also scans `~/.claude/skills` and `~/.claude/agents` — those entries are the
same symlinked files, deduplicated by `name`.

```bash
make ai # install skills into all registered tools
make ai # ai-check, then install skills into all registered tools
make ai-check # lint SKILL.md <-> agents/openai.yaml (invocation policy, legacy keys, leftovers)
make ai-skill-meta # scaffold agents/openai.yaml for skills missing one
make ai-list # show skills + tool registry
make ai-clean # remove installed skills everywhere
make claude # claude layer (agents/personas/configs/scripts/settings) + ai-claude
Expand All @@ -67,8 +72,11 @@ AI_TOOLS += cline
ai_skills_dir_cline := ${HOME}/.cline/skills
```

**Add a skill** — create `ai-stuff/skills/<name>/SKILL.md`, run `make ai`.
Nothing else; discovery is by wildcard.
**Add a skill** — create `ai-stuff/skills/<name>/SKILL.md`, decide whether it
is user- or model-invoked per [`invocation.md`](invocation.md), run
`make ai-skill-meta` and curate the generated `agents/openai.yaml`
`short_description`, then `make ai`. Discovery is by wildcard; `ai-check`
refuses to install if the two metadata files disagree.

**Retire a skill** — move its dir to `skills/.archived/` and append the name
to `AI_LEGACY_SKILLS` in `ai.mk` so installs prune it everywhere (BMAD's
Expand All @@ -92,7 +100,14 @@ Skills must work in any tool. Rules used throughout `skills/`:
3. **Claude-specific frontmatter keys are kept** (`allowed-tools`, `agent`,
`context: fork`, `disable-model-invocation`). The Agent Skills spec says
unknown keys are ignored, so other tools skip them. Claude Code is the
primary driver here; don't strip its metadata for purity.
primary driver here; don't strip its metadata for purity. The one key
with a cross-tool twin is `disable-model-invocation`: it must agree with
`policy.allow_implicit_invocation` in `agents/openai.yaml` (Codex). Rules
and the openai.yaml schema live in [`invocation.md`](invocation.md).

6. **Cross-skill calls say `Call the Skill tool with "<name>"`**, never
`/name`, and only ever target a model-invoked skill. See
[`invocation.md`](invocation.md).

4. **Executable helpers used by universal skills live in `_shared/scripts/`**
and are referenced via `~/.config/ai-shared/scripts/...` (e.g.
Expand All @@ -115,7 +130,8 @@ Anything that is *not* a skill stays out of `skills/`:
file works in every tool that can read files.
- **`claude/`** — `settings.json` (hooks, permissions, statusline, plugins)
and Claude-only hook scripts. See [claude/README.md](claude/README.md).
- **`codex/`** — `hooks.json` + Codex-only hook scripts. See
- **`codex/`** — `hooks.json` + Codex-only hook scripts. Codex skill-picker
metadata is *not* here: it lives beside each skill in `agents/openai.yaml`. See
[codex/README.md](codex/README.md).
- **`_shared/scripts/`** — scripts shared across tools. Hook scripts
(`auto-approve-tools.sh`, `focus-iterm.applescript`): Codex adopted Claude
Expand Down
4 changes: 2 additions & 2 deletions ai-stuff/_shared/personas/mega-dev.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,8 +34,8 @@ You are **Mega-Dev**, the Elite Full-Stack Developer and Quick Flow Specialist.
## Orchestration Capabilities

Mega-Dev can coordinate:
- `/dev-story` - Fetch and understand Jira stories
- `/commit` - Delegate to GitBoi for conventional commits
- `/get-story` - Fetch and understand Jira stories
- `/auto-commit` - Delegate to GitBoi for conventional commits
- `/create-pr` - Delegate to GitBoi for PR/MR creation
- `/create-story` - Delegate to Jira Girl for issue creation

Expand Down
9 changes: 4 additions & 5 deletions ai-stuff/agents/mega-dev.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,25 +15,24 @@ You are **Mega-Dev**, the Elite Full-Stack Developer and Quick Flow Specialist.
You orchestrate the complete development flow:
- Fetch story context from Jira
- Implement features and fixes
- Create commits (delegate to GitBoi via `/commit`)
- Create commits (delegate to GitBoi via `/auto-commit`)
- Create PRs (delegate to GitBoi via `/create-pr`)
- Update Jira status and comments

## Available Skills

| Skill | Description |
|-------|-------------|
| `/commit` | Create conventional commit (GitBoi) |
| `/auto-commit` | Group and create conventional commits (GitBoi) |
| `/create-pr` | Create PR/MR (GitBoi) |
| `/get-story <KEY>` | Fetch Jira issue (Jira Girl) |
| `/create-story <desc>` | Create Jira issue (Jira Girl) |
| `/dev-story <KEY>` | Fetch story for development |

## Workflow: Story to PR

1. **Fetch**: `/dev-story DEVX-123`
1. **Fetch**: `/get-story DEVX-123`
2. **Implement**: Write the code
3. **Commit**: `/commit`
3. **Commit**: `/auto-commit`
4. **Ship**: `/create-pr`
5. **Update**: Transition Jira if needed

Expand Down
3 changes: 2 additions & 1 deletion ai-stuff/claude/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ cross-tool architecture.
ai-stuff/claude/
├── scripts/ # Claude-only hook + integration scripts (→ ~/.claude/scripts)
│ ├── file-suggestion.sh # Custom file suggestion using rg + fzf
│ ├── statusline.sh # Statusline with git, context, vim mode
│ ├── statusline.sh # Main-session statusline with git, context, vim mode
│ ├── subagent-statusline.sh # Subagent rows with each task's resolved model
│ ├── session-start.sh # Auto-name worktree sessions
│ ├── notify.sh # Notification-event alert (claude-only event)
│ └── worktree-*.sh # EnterWorktree/ExitWorktree hook scripts (claude hook protocol)
Expand Down
Loading
Loading