setup-idat

Configure accomplishment logging within the `.things/` directory managed by things. Creates per-plugin directories, registers collections, seeds shared resources, and sets logging preferences. Check Prerequisites

<load-config>
  <action>Resolve the user's home directory.</action>
  <command language="bash" output="home" tool="Bash">echo $HOME</command>
  <constraint>Never pass `~` to the Read tool.</constraint>

  <read path="<home>/.things/config.json" output="config" />
  <if condition="config-missing">Tell the user: "Run `/things:setup-things` first to initialize your .things directory." Then stop.<exit /></if>

  <read path="<home>/.things/registry.json" output="registry" />

  <action>Check if preferences already exist.</action>
  <read path="<home>/.things/i-did-a-thing/preferences.json" output="preferences" />
  <if condition="preferences-exist">Show current settings and ask if they want to reconfigure.</if>
  <if condition="preferences-missing">Fresh setup (continue to Step 2).</if>

  <if condition="reconfiguring">Show current settings as defaults throughout.</if>
</load-config>

Create Plugin Directories

<command language="bash" tool="Bash">mkdir -p <home>/.things/i-did-a-thing/logs

mkdir -p /.things/i-did-a-thing/arsenal mkdir -p /.things/i-did-a-thing/resumes

Register Collections

<action>Read `<home>/.things/registry.json` and add these collections (skip any already registered).</action>

<schema name="logs-collection">
i-did-a-thing/logs:
```json
{
  "plugin": "i-did-a-thing",
  "description": "Professional experience log entries",
  "tags_field": "frontmatter.tags",
  "item_structure": {
    "directory_per_item": false,
    "file_pattern": "*.md"
  },
  "index_schema": {
    "required_fields": {
      "title": "string",
      "date": "date",
      "evidence_type": "string",
      "impact": "string",
      "category": "string"
    },
    "optional_fields": {
      "tags": "string[]",
      "skills_used": "string[]"
    }
  },
  "master_index": "i-did-a-thing/index.json",
  "rebuild_command": "python3 ${PLUGIN_PATH:i-did-a-thing@brenna-plugs}/scripts/rebuild-data.py ${THINGS_PATH}"
}
```
</schema>

<schema name="arsenal-collection">
i-did-a-thing/arsenal:
```json
{
  "plugin": "i-did-a-thing",
  "description": "Auto-generated skill summary files",
  "item_structure": {
    "directory_per_item": false,
    "file_pattern": "*.md"
  },
  "index_schema": {},
  "master_index": null,
  "rebuild_command": null
}
```
</schema>

<schema name="resumes-collection">
i-did-a-thing/resumes:
```json
{
  "plugin": "i-did-a-thing",
  "description": "Generated resume files",
  "item_structure": {
    "directory_per_item": false,
    "file_pattern": "*.md"
  },
  "index_schema": {},
  "master_index": null,
  "rebuild_command": null
}
```
</schema>

<write path="<home>/.things/registry.json" content="updated registry with new collections" />

Create Initial Index Files

<if condition="index-missing">
  <write path="<home>/.things/i-did-a-thing/index.json">
  ```json
  {
    "version": 1,
    "last_updated": "<current_date>",
    "total_entries": 0,
    "entries": []
  }
  ```
  </write>
</if>

<if condition="tags-missing">
  <write path="<home>/.things/i-did-a-thing/tags.json">
  ```json
  {
    "last_updated": "<current_date>",
    "tags": {}
  }
  ```
  </write>
</if>

Gather Preferences

<ask-user-question>
  <question>Default tags for your logs? (comma-separated, e.g., `engineering, python, leadership`)</question>
  <option-with-text-input>Enter tags</option-with-text-input>
</ask-user-question>

Write Preferences

<write path="<home>/.things/i-did-a-thing/preferences.json">
```json
{
  "default_tags": ["<tag1>", "<tag2>"]
}
```
</write>

Seed Shared Resources

<action>Seed persona files to `<home>/.things/shared/roles/` if not already present. The bundled personas are at `<plugin_root>/personas/`.</action>
<command language="bash" tool="Bash">for f in <plugin_root>/personas/*.md; do

dest="/.things/shared/roles/$(basename "$f")" [ -f "$dest" ] || cp "$f" "$dest" done

<action>Seed company profiles to `<home>/.things/shared/companies/` if not already present.</action>
<command language="bash" tool="Bash">for f in <plugin_root>/companies/*.yaml; do

dest="/.things/shared/companies/$(basename "$f")" [ -f "$dest" ] || cp "$f" "$dest" done

Update Environment Tracking

<action>Read `<home>/.things/config.json` and get hostname.</action>
<command language="bash" output="hostname" tool="Bash">hostname -s 2>/dev/null || scutil --get LocalHostName 2>/dev/null || echo "unknown"</command>

<action>Update the `environments.<hostname>.plugins` array to include `"i-did-a-thing"` if not already present. Update `last_active` to today's date. Write back `config.json`.</action>

Handle Git

<git-workflow>
  <action>Read git workflow from `<home>/.things/config.json`.</action>

  <if condition="workflow-auto">
    <command language="bash" tool="Bash">git -C <home>/.things add -A && git -C <home>/.things commit -m "setup: i-did-a-thing" && git -C <home>/.things push</command>
  </if>
  <if condition="workflow-ask">
    <ask-user-question>
      <question>Commit setup files to .things repo?</question>
      <option>Yes -- commit and push</option>
      <option>Commit only -- commit without pushing</option>
      <option>No -- I'll handle git myself</option>
    </ask-user-question>
  </if>
  <if condition="workflow-manual">Tell the user what files were created.</if>
</git-workflow>

Confirm Setup

<completion-message>
i-did-a-thing is ready!

- Logs: `<home>/.things/i-did-a-thing/logs/`
- Arsenal: `<home>/.things/i-did-a-thing/arsenal/`
- Resumes: `<home>/.things/i-did-a-thing/resumes/`
- Collections registered in registry.json

Quick start:
- `/thing-i-did` -- Log something you did
- `/construct-resume` -- Build a resume for a job listing
</completion-message>