64 lines
2.1 KiB
Markdown
64 lines
2.1 KiB
Markdown
# Import / Export System
|
|
|
|
Portable packaging for agent systems. Export a working agent system from one
|
|
project and import it into another, with automatic placeholder substitution.
|
|
|
|
## Export
|
|
|
|
Pack your current agent system into a tarball:
|
|
|
|
```bash
|
|
bash scripts/templates/transfer/export-system.sh my-project-name
|
|
# Creates: agent-system-my-project-name-2026-04-11.tar.gz
|
|
```
|
|
|
|
### What is included
|
|
|
|
| Included | Excluded |
|
|
|---------|---------|
|
|
| `.claude/agents/` | `.env` (secrets) |
|
|
| `.claude/skills/` | `*.local.*` files |
|
|
| `.claude/hooks/` | `audit.log` |
|
|
| `.claude/settings.json` | `cost-events.jsonl` |
|
|
| `hooks/` | `memory/` (machine-specific state) |
|
|
| `automation/` | `.git/` |
|
|
| `scripts/` | |
|
|
| `CLAUDE.md` | |
|
|
|
|
## Import
|
|
|
|
Extract a tarball into a new project directory:
|
|
|
|
```bash
|
|
# Dry run first: inspect without extracting
|
|
tar -tzf agent-system-my-project-name-2026-04-11.tar.gz
|
|
|
|
# Import (will stop if files conflict)
|
|
bash scripts/templates/transfer/import-system.sh agent-system-my-project-name-2026-04-11.tar.gz
|
|
|
|
# Import and overwrite existing files
|
|
bash scripts/templates/transfer/import-system.sh agent-system-my-project-name-2026-04-11.tar.gz --force
|
|
```
|
|
|
|
The import script will:
|
|
1. Read `MANIFEST.md` and verify the archive
|
|
2. Check for conflicts with existing files (stops unless `--force`)
|
|
3. Extract all files
|
|
4. Replace `{{PROJECT_DIR}}` and `{{PROJECT_NAME}}` placeholders
|
|
5. Make `.sh` files executable
|
|
6. Validate agent frontmatter and hook syntax
|
|
|
|
## Customization after import
|
|
|
|
1. **Update `CLAUDE.md`** — replace project-specific context, goals, and constraints
|
|
2. **Add secrets** — create `.env` with `ANTHROPIC_API_KEY=sk-ant-...`
|
|
3. **Review hooks** — check that paths in hook scripts match your environment
|
|
4. **Run `/agent-factory:status`** — verify all components load correctly
|
|
5. **Run `/agent-factory:evaluate`** — check capability coverage
|
|
|
|
## Manifest
|
|
|
|
Each export includes `MANIFEST.md` listing every file with a SHA256 checksum
|
|
(first 16 hex characters). Use this to verify file integrity after transfer.
|
|
|
|
Template manifest: `scripts/templates/transfer/MANIFEST.md`
|