# GPT Factory Skill

status: DONE
task IDs: #11
source request: Owner requested `/gpt-factory` so any agent can invoke Factory with GPT Sol without exploratory turns. Skill MUST pin exact repository snapshot/context packaging, attachment semantics, commands, and one-line title rule.

## Outcome

Ship installed global `/gpt-factory` skill that launches `factory-gpt` correctly from complete file-backed context.

## Acceptance criteria

- Skill states GPT/Sol has no implicit host/repository context; required context MUST be files reachable from launch checkout and explicitly named in request file.
- Skill pins repository identity: worktree path, `HEAD`, `origin/main`, merge-base, status, diff, untracked manifest, instructions, plan/spec, bounded source/tests.
- Skill gives exact safe commands for context directory, metadata capture, request file, validation, launch, watch, stop, and decision answer.
- Prompt/request first line MUST be one-line job description because it becomes conversation title.
- Skill forbids secrets, `.git`, dependency trees, caches, broad archives, shared-main mutation, hidden fallback, and direct model verification.
- Deterministic contract test passes; installed skill bytes match landed source; invocation is discoverable.

## Preserved WIP

- Worktree: `/home/user/Projects/overdeck/.worktrees/factory-gpt-final`
- Branch: `wt/factory-gpt-final`
- Base at request: `496b1f814512e191aa00c564eee5b66e53eba4a8`
- Preserve unrelated worktrees and shared-main WIP.

## Constraints

- Agent-facing doc: concise imperative register; exact commands; no `--help` exploration requirement.
- `factory-gpt` accepts exactly `<adw> <prompt-or-path>` and defaults to Pro.
- Factory/Pi supplies mediated tools; attachments provide authoritative initial context, not a model-authored command channel.
- Install before landing; then land/deploy and verify installed invocation.

## Execution steps

1. Author skill and deterministic contract test.
2. Run focused test and installed skill invocation proof.
3. Land, deploy, verify installed bytes and command examples.

## Current receipt

- Task #11 completed by main session.
- Skill and deterministic contract test landed in `924664313`; contract PASS before landing.
- Canonical `packaging/deploy-local.sh` deployed source at `924664313` and reused unchanged web release.
- Installed `~/.claude/skills/gpt-factory/SKILL.md` exists through aggregate skills symlink, matches landed source byte-for-byte, and installed contract test passes.
- Skill registry exposes `gpt-factory` for agent invocation.
- Deployment reported pre-existing `shim-drift-check: HAZARD` in unrelated worktrees; no related files were modified or discarded.

## Next executable action

None — installed and owner-usable.
