https://github.com/urous3814/kyle-vault-starterkit
Kyle-style shared vault and agent workspace starterkit for Conductor, Codex, and Claude
https://github.com/urous3814/kyle-vault-starterkit
agent-workspace claude-code codex conductor starterkit vault worktree
Last synced: about 7 hours ago
JSON representation
Kyle-style shared vault and agent workspace starterkit for Conductor, Codex, and Claude
- Host: GitHub
- URL: https://github.com/urous3814/kyle-vault-starterkit
- Owner: urous3814
- License: mit
- Created: 2026-06-09T06:07:38.000Z (11 days ago)
- Default Branch: main
- Last Pushed: 2026-06-09T06:18:52.000Z (11 days ago)
- Last Synced: 2026-06-09T08:17:12.564Z (11 days ago)
- Topics: agent-workspace, claude-code, codex, conductor, starterkit, vault, worktree
- Language: Shell
- Size: 28.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Kyle Vault Starterkit
Kyle-style shared vault and agent workspace starterkit.
This starterkit installs a reusable coding-agent setup for repos that need:
- a shared `./kyle` vault across local worktrees or Conductor workspaces
- repo and workspace `AGENTS.md` / `CLAUDE.md` templates
- Conductor-safe setup via `conductor.json` and `scripts/conductor-setup.sh`
- append-only agent live logging
- standard vault foldering rules
- optional `ONBOARDING.md` creation for first-day repo context
## Fast Start
```bash
git clone https://github.com/urous3814/kyle-vault-starterkit.git
cd kyle-vault-starterkit
# Install both local agent skills.
bash skill/kyle-vault-workspace/scripts/install-starterkit.sh \
--repo-root "$PWD" \
--skip-repo-files \
--skip-vault \
--skip-workspace-files \
--install-agent-skills
# Install the starterkit into a target repo/workspace.
bash skill/kyle-vault-workspace/scripts/install-starterkit.sh \
--repo-root /path/to/repo \
--workspace-root /path/to/workspace \
--vault-name kyle \
--with-onboarding
```
After installing agent skills:
- Codex can use `kyle-vault-workspace` from `${CODEX_HOME:-$HOME/.codex}/skills/kyle-vault-workspace`.
- Claude Code can use `kyle-vault-workspace` from `${CLAUDE_HOME:-$HOME/.claude}/skills/kyle-vault-workspace`.
## Agent-Assisted Install
You can give this GitHub link to a coding agent and ask it to install the skill for you:
```text
https://github.com/urous3814/kyle-vault-starterkit
```
Use this prompt for Codex or Claude Code:
```text
Install this starterkit as a local agent skill and then use the kyle-vault-workspace skill to set up this repo:
https://github.com/urous3814/kyle-vault-starterkit
Requirements:
- Clone the repo into a temporary directory.
- Read README.md and skill/kyle-vault-workspace/SKILL.md before running scripts.
- Install the local agent skill for the current agent.
- If this is Codex, install to ${CODEX_HOME:-$HOME/.codex}/skills/kyle-vault-workspace.
- If this is Claude Code, install to ${CLAUDE_HOME:-$HOME/.claude}/skills/kyle-vault-workspace.
- Do not overwrite existing files unless I explicitly approve --force.
- After installing the skill, use it to configure the current repo/workspace.
- Ask me for the vault name if it should not be "kyle".
- Ask me whether to create kyle/06-ops/ONBOARDING.md.
- Run the starterkit verification scripts and report the installed paths.
```
If the agent can run shell commands, it can use this implementation outline:
```bash
tmp="$(mktemp -d)"
git clone https://github.com/urous3814/kyle-vault-starterkit.git "$tmp/kyle-vault-starterkit"
cd "$tmp/kyle-vault-starterkit"
# For Codex:
bash skill/kyle-vault-workspace/scripts/install-starterkit.sh \
--repo-root "$PWD" \
--skip-repo-files \
--skip-vault \
--skip-workspace-files \
--install-codex-skill
# For Claude Code:
bash skill/kyle-vault-workspace/scripts/install-starterkit.sh \
--repo-root "$PWD" \
--skip-repo-files \
--skip-vault \
--skip-workspace-files \
--install-claude-skill
```
## Layout
```text
.
├── README.md
├── scripts/
│ └── verify-starterkit.sh
└── skill/kyle-vault-workspace/
├── SKILL.md
├── scripts/
│ ├── install-starterkit.sh
│ └── verify-starterkit.sh
└── assets/
├── repo/ # files copied into a target git repo
├── workspace/ # optional parent workspace files
├── vault/ # default shared kyle vault seed
└── optional/ # opt-in files such as ONBOARDING.md
```
## Install Into A Repo
Run from this repository or from any shell that can reach the starterkit:
```bash
bash skill/kyle-vault-workspace/scripts/install-starterkit.sh \
--repo-root /path/to/repo \
--workspace-root /path/to/workspace
```
Defaults:
- `--repo-root` defaults to the current git root or current directory.
- `--workspace-root` defaults to the repo parent directory.
- `--vault-name` defaults to `kyle`.
- `--vault-root` defaults to `$workspace_root/$vault_name`.
- Existing files are preserved.
- `./kyle`, `.context/`, `.claude/agents`, and `.env.local` are added to local git exclude.
## Vault Name
Use `--vault-name` when the shared vault directory under the workspace root should not be named `kyle`:
```bash
bash skill/kyle-vault-workspace/scripts/install-starterkit.sh \
--repo-root /path/to/repo \
--workspace-root /path/to/workspace \
--vault-name product-vault
```
This creates:
```text
/path/to/workspace/product-vault/
/path/to/repo/kyle -> /path/to/workspace/product-vault
```
The repo symlink remains `./kyle` so agent instructions can stay stable across projects. To choose an exact vault path instead of a workspace-local name, use `--vault-root /absolute/path/to/vault`. Use either `--vault-name` or `--vault-root`, not both.
## Safety Options
```bash
# Preview without writing files
bash skill/kyle-vault-workspace/scripts/install-starterkit.sh \
--repo-root /path/to/repo \
--dry-run
# Backup and replace changed existing files
bash skill/kyle-vault-workspace/scripts/install-starterkit.sh \
--repo-root /path/to/repo \
--force
```
`--force` renames changed existing files with a `.starterkit-backup.` suffix before writing replacements.
## Onboarding
The installer can create `kyle/06-ops/ONBOARDING.md` from the starter template.
```bash
# Always create ONBOARDING.md
bash skill/kyle-vault-workspace/scripts/install-starterkit.sh \
--repo-root /path/to/repo \
--with-onboarding
# Never create ONBOARDING.md
bash skill/kyle-vault-workspace/scripts/install-starterkit.sh \
--repo-root /path/to/repo \
--no-onboarding
```
Default behavior:
- In an interactive terminal, the installer asks before creating `ONBOARDING.md`.
- In non-interactive environments, it skips onboarding unless `--with-onboarding` or `STARTERKIT_CREATE_ONBOARDING=1` is set.
## Conductor
Conductor owns workspace and worktree creation. Do not run local worktree creation scripts inside a Conductor workspace.
The installed repo template includes:
```json
{
"scripts": {
"setup": "./scripts/conductor-setup.sh"
}
}
```
The setup script:
- runs from the Conductor workspace directory
- uses `CONDUCTOR_ROOT_PATH` to find the original repo root when needed
- links `./kyle` to the shared vault when available
- links `.context/workspace-AGENTS.md` and `.context/workspace-CLAUDE.md` when parent workspace files exist
- preserves `.env.local` as a local symlink when possible
- uses `CONDUCTOR_SETUP_SKIP_INSTALL=1` for fast script verification
Run scripts should bind app servers to `CONDUCTOR_PORT` when the project supports configurable ports.
## Install As Agent Skills
Install both Codex and Claude Code skills:
```bash
bash skill/kyle-vault-workspace/scripts/install-starterkit.sh \
--repo-root "$PWD" \
--skip-repo-files \
--skip-vault \
--skip-workspace-files \
--install-agent-skills
```
Install only Codex:
```bash
bash skill/kyle-vault-workspace/scripts/install-starterkit.sh \
--repo-root "$PWD" \
--skip-repo-files \
--skip-vault \
--skip-workspace-files \
--install-codex-skill
```
This copies the skill to:
```text
${CODEX_HOME:-$HOME/.codex}/skills/kyle-vault-workspace
```
Install only Claude Code:
```bash
bash skill/kyle-vault-workspace/scripts/install-starterkit.sh \
--repo-root "$PWD" \
--skip-repo-files \
--skip-vault \
--skip-workspace-files \
--install-claude-skill
```
This copies the skill to:
```text
${CLAUDE_HOME:-$HOME/.claude}/skills/kyle-vault-workspace
```
Claude Code skills use the same `SKILL.md` package shape as this starterkit. The directory name and `name` field are both `kyle-vault-workspace`.
Use `--skip-repo-files` for skill-only installation so the starterkit does not copy repo templates into the starterkit checkout itself.
## Repository Defaults
The standalone GitHub repository includes:
- MIT license
- security policy
- contributing guide
- code of conduct
- issue templates
- pull request template
- GitHub Actions verification workflow
## Verify
Verify the starterkit itself:
```bash
bash scripts/verify-starterkit.sh
bash skill/kyle-vault-workspace/scripts/verify-starterkit.sh
```
Verify an installed repo:
```bash
bash /path/to/repo/scripts/test-conductor-setup.sh
jq empty /path/to/workspace/kyle/06-ops/agent-live-log.json
git -C /path/to/repo status --short
```
If you installed with `--vault-name product-vault`, replace `/path/to/workspace/kyle` with `/path/to/workspace/product-vault`.
Expected result:
- shell scripts parse
- JSON files are valid
- local symlinks and context files are ignored
- existing repo files were preserved unless `--force` was used
## Standard Vault Folders
The starterkit seeds these folders:
```text
01-product/
02-design/
03-engineering/
04-ops/
05-checklists/
06-ops/
07-critique/
08-security/
assets/
```
Detailed placement rules live in:
```text
kyle/06-ops/vault-foldering-rules.md
```
Do not rename a mature existing vault just to match this template. Keep existing domain folders when they are already clear and stable.
## License
MIT License. See `LICENSE`.