{"id":50982781,"url":"https://github.com/urous3814/kyle-vault-starterkit","last_synced_at":"2026-06-19T16:03:54.517Z","repository":{"id":363503082,"uuid":"1263633109","full_name":"urous3814/kyle-vault-starterkit","owner":"urous3814","description":"Kyle-style shared vault and agent workspace starterkit for Conductor, Codex, and Claude","archived":false,"fork":false,"pushed_at":"2026-06-09T06:18:52.000Z","size":29,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-09T08:17:12.564Z","etag":null,"topics":["agent-workspace","claude-code","codex","conductor","starterkit","vault","worktree"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/urous3814.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-09T06:07:38.000Z","updated_at":"2026-06-09T06:18:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/urous3814/kyle-vault-starterkit","commit_stats":null,"previous_names":["urous3814/kyle-vault-starterkit"],"tags_count":null,"template":true,"template_full_name":null,"purl":"pkg:github/urous3814/kyle-vault-starterkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urous3814%2Fkyle-vault-starterkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urous3814%2Fkyle-vault-starterkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urous3814%2Fkyle-vault-starterkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urous3814%2Fkyle-vault-starterkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/urous3814","download_url":"https://codeload.github.com/urous3814/kyle-vault-starterkit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urous3814%2Fkyle-vault-starterkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34538480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-19T02:00:06.005Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-workspace","claude-code","codex","conductor","starterkit","vault","worktree"],"created_at":"2026-06-19T16:03:53.600Z","updated_at":"2026-06-19T16:03:54.509Z","avatar_url":"https://github.com/urous3814.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kyle Vault Starterkit\n\nKyle-style shared vault and agent workspace starterkit.\n\nThis starterkit installs a reusable coding-agent setup for repos that need:\n\n- a shared `./kyle` vault across local worktrees or Conductor workspaces\n- repo and workspace `AGENTS.md` / `CLAUDE.md` templates\n- Conductor-safe setup via `conductor.json` and `scripts/conductor-setup.sh`\n- append-only agent live logging\n- standard vault foldering rules\n- optional `ONBOARDING.md` creation for first-day repo context\n\n## Fast Start\n\n```bash\ngit clone https://github.com/urous3814/kyle-vault-starterkit.git\ncd kyle-vault-starterkit\n\n# Install both local agent skills.\nbash skill/kyle-vault-workspace/scripts/install-starterkit.sh \\\n  --repo-root \"$PWD\" \\\n  --skip-repo-files \\\n  --skip-vault \\\n  --skip-workspace-files \\\n  --install-agent-skills\n\n# Install the starterkit into a target repo/workspace.\nbash skill/kyle-vault-workspace/scripts/install-starterkit.sh \\\n  --repo-root /path/to/repo \\\n  --workspace-root /path/to/workspace \\\n  --vault-name kyle \\\n  --with-onboarding\n```\n\nAfter installing agent skills:\n\n- Codex can use `kyle-vault-workspace` from `${CODEX_HOME:-$HOME/.codex}/skills/kyle-vault-workspace`.\n- Claude Code can use `kyle-vault-workspace` from `${CLAUDE_HOME:-$HOME/.claude}/skills/kyle-vault-workspace`.\n\n## Agent-Assisted Install\n\nYou can give this GitHub link to a coding agent and ask it to install the skill for you:\n\n```text\nhttps://github.com/urous3814/kyle-vault-starterkit\n```\n\nUse this prompt for Codex or Claude Code:\n\n```text\nInstall this starterkit as a local agent skill and then use the kyle-vault-workspace skill to set up this repo:\n\nhttps://github.com/urous3814/kyle-vault-starterkit\n\nRequirements:\n- Clone the repo into a temporary directory.\n- Read README.md and skill/kyle-vault-workspace/SKILL.md before running scripts.\n- Install the local agent skill for the current agent.\n- If this is Codex, install to ${CODEX_HOME:-$HOME/.codex}/skills/kyle-vault-workspace.\n- If this is Claude Code, install to ${CLAUDE_HOME:-$HOME/.claude}/skills/kyle-vault-workspace.\n- Do not overwrite existing files unless I explicitly approve --force.\n- After installing the skill, use it to configure the current repo/workspace.\n- Ask me for the vault name if it should not be \"kyle\".\n- Ask me whether to create kyle/06-ops/ONBOARDING.md.\n- Run the starterkit verification scripts and report the installed paths.\n```\n\nIf the agent can run shell commands, it can use this implementation outline:\n\n```bash\ntmp=\"$(mktemp -d)\"\ngit clone https://github.com/urous3814/kyle-vault-starterkit.git \"$tmp/kyle-vault-starterkit\"\ncd \"$tmp/kyle-vault-starterkit\"\n\n# For Codex:\nbash skill/kyle-vault-workspace/scripts/install-starterkit.sh \\\n  --repo-root \"$PWD\" \\\n  --skip-repo-files \\\n  --skip-vault \\\n  --skip-workspace-files \\\n  --install-codex-skill\n\n# For Claude Code:\nbash skill/kyle-vault-workspace/scripts/install-starterkit.sh \\\n  --repo-root \"$PWD\" \\\n  --skip-repo-files \\\n  --skip-vault \\\n  --skip-workspace-files \\\n  --install-claude-skill\n```\n\n## Layout\n\n```text\n.\n├── README.md\n├── scripts/\n│   └── verify-starterkit.sh\n└── skill/kyle-vault-workspace/\n    ├── SKILL.md\n    ├── scripts/\n    │   ├── install-starterkit.sh\n    │   └── verify-starterkit.sh\n    └── assets/\n        ├── repo/       # files copied into a target git repo\n        ├── workspace/  # optional parent workspace files\n        ├── vault/      # default shared kyle vault seed\n        └── optional/   # opt-in files such as ONBOARDING.md\n```\n\n## Install Into A Repo\n\nRun from this repository or from any shell that can reach the starterkit:\n\n```bash\nbash skill/kyle-vault-workspace/scripts/install-starterkit.sh \\\n  --repo-root /path/to/repo \\\n  --workspace-root /path/to/workspace\n```\n\nDefaults:\n\n- `--repo-root` defaults to the current git root or current directory.\n- `--workspace-root` defaults to the repo parent directory.\n- `--vault-name` defaults to `kyle`.\n- `--vault-root` defaults to `$workspace_root/$vault_name`.\n- Existing files are preserved.\n- `./kyle`, `.context/`, `.claude/agents`, and `.env.local` are added to local git exclude.\n\n## Vault Name\n\nUse `--vault-name` when the shared vault directory under the workspace root should not be named `kyle`:\n\n```bash\nbash skill/kyle-vault-workspace/scripts/install-starterkit.sh \\\n  --repo-root /path/to/repo \\\n  --workspace-root /path/to/workspace \\\n  --vault-name product-vault\n```\n\nThis creates:\n\n```text\n/path/to/workspace/product-vault/\n/path/to/repo/kyle -\u003e /path/to/workspace/product-vault\n```\n\nThe 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.\n\n## Safety Options\n\n```bash\n# Preview without writing files\nbash skill/kyle-vault-workspace/scripts/install-starterkit.sh \\\n  --repo-root /path/to/repo \\\n  --dry-run\n\n# Backup and replace changed existing files\nbash skill/kyle-vault-workspace/scripts/install-starterkit.sh \\\n  --repo-root /path/to/repo \\\n  --force\n```\n\n`--force` renames changed existing files with a `.starterkit-backup.\u003ctimestamp\u003e` suffix before writing replacements.\n\n## Onboarding\n\nThe installer can create `kyle/06-ops/ONBOARDING.md` from the starter template.\n\n```bash\n# Always create ONBOARDING.md\nbash skill/kyle-vault-workspace/scripts/install-starterkit.sh \\\n  --repo-root /path/to/repo \\\n  --with-onboarding\n\n# Never create ONBOARDING.md\nbash skill/kyle-vault-workspace/scripts/install-starterkit.sh \\\n  --repo-root /path/to/repo \\\n  --no-onboarding\n```\n\nDefault behavior:\n\n- In an interactive terminal, the installer asks before creating `ONBOARDING.md`.\n- In non-interactive environments, it skips onboarding unless `--with-onboarding` or `STARTERKIT_CREATE_ONBOARDING=1` is set.\n\n## Conductor\n\nConductor owns workspace and worktree creation. Do not run local worktree creation scripts inside a Conductor workspace.\n\nThe installed repo template includes:\n\n```json\n{\n  \"scripts\": {\n    \"setup\": \"./scripts/conductor-setup.sh\"\n  }\n}\n```\n\nThe setup script:\n\n- runs from the Conductor workspace directory\n- uses `CONDUCTOR_ROOT_PATH` to find the original repo root when needed\n- links `./kyle` to the shared vault when available\n- links `.context/workspace-AGENTS.md` and `.context/workspace-CLAUDE.md` when parent workspace files exist\n- preserves `.env.local` as a local symlink when possible\n- uses `CONDUCTOR_SETUP_SKIP_INSTALL=1` for fast script verification\n\nRun scripts should bind app servers to `CONDUCTOR_PORT` when the project supports configurable ports.\n\n## Install As Agent Skills\n\nInstall both Codex and Claude Code skills:\n\n```bash\nbash skill/kyle-vault-workspace/scripts/install-starterkit.sh \\\n  --repo-root \"$PWD\" \\\n  --skip-repo-files \\\n  --skip-vault \\\n  --skip-workspace-files \\\n  --install-agent-skills\n```\n\nInstall only Codex:\n\n```bash\nbash skill/kyle-vault-workspace/scripts/install-starterkit.sh \\\n  --repo-root \"$PWD\" \\\n  --skip-repo-files \\\n  --skip-vault \\\n  --skip-workspace-files \\\n  --install-codex-skill\n```\n\nThis copies the skill to:\n\n```text\n${CODEX_HOME:-$HOME/.codex}/skills/kyle-vault-workspace\n```\n\nInstall only Claude Code:\n\n```bash\nbash skill/kyle-vault-workspace/scripts/install-starterkit.sh \\\n  --repo-root \"$PWD\" \\\n  --skip-repo-files \\\n  --skip-vault \\\n  --skip-workspace-files \\\n  --install-claude-skill\n```\n\nThis copies the skill to:\n\n```text\n${CLAUDE_HOME:-$HOME/.claude}/skills/kyle-vault-workspace\n```\n\nClaude Code skills use the same `SKILL.md` package shape as this starterkit. The directory name and `name` field are both `kyle-vault-workspace`.\n\nUse `--skip-repo-files` for skill-only installation so the starterkit does not copy repo templates into the starterkit checkout itself.\n\n## Repository Defaults\n\nThe standalone GitHub repository includes:\n\n- MIT license\n- security policy\n- contributing guide\n- code of conduct\n- issue templates\n- pull request template\n- GitHub Actions verification workflow\n\n## Verify\n\nVerify the starterkit itself:\n\n```bash\nbash scripts/verify-starterkit.sh\nbash skill/kyle-vault-workspace/scripts/verify-starterkit.sh\n```\n\nVerify an installed repo:\n\n```bash\nbash /path/to/repo/scripts/test-conductor-setup.sh\njq empty /path/to/workspace/kyle/06-ops/agent-live-log.json\ngit -C /path/to/repo status --short\n```\n\nIf you installed with `--vault-name product-vault`, replace `/path/to/workspace/kyle` with `/path/to/workspace/product-vault`.\n\nExpected result:\n\n- shell scripts parse\n- JSON files are valid\n- local symlinks and context files are ignored\n- existing repo files were preserved unless `--force` was used\n\n## Standard Vault Folders\n\nThe starterkit seeds these folders:\n\n```text\n01-product/\n02-design/\n03-engineering/\n04-ops/\n05-checklists/\n06-ops/\n07-critique/\n08-security/\nassets/\n```\n\nDetailed placement rules live in:\n\n```text\nkyle/06-ops/vault-foldering-rules.md\n```\n\nDo not rename a mature existing vault just to match this template. Keep existing domain folders when they are already clear and stable.\n\n## License\n\nMIT License. See `LICENSE`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furous3814%2Fkyle-vault-starterkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Furous3814%2Fkyle-vault-starterkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furous3814%2Fkyle-vault-starterkit/lists"}