import-ftrlisted

<purpose> Import existing documentation files into `for-the-record/docs/`. The user specifies where to import from -- there is no default source directory. Generates proper frontmatter for each imported file. </purpose> <steps> <step id="load-config" number="1"> <description>Load Configuration</description> <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." Then stop.<exit /></if> <read path="<home>/.things/for-the-record/preferences.json" output="preferences" /> <if condition="preferences-missing">Tell the user: "Run `/setup-ftr` first." Then stop.<exit /></if> </load-config> </step> <step id="get-source" number="2"> <description>Get Source Directory</description> <if condition="path-argument-provided"> <action>Use the provided path as the source directory.</action> </if> <if condition="no-path-argument"> <ask-user-question> <question>Where are the files you'd like to import?</question> </ask-user-question> </if> <action>Verify the path exists and is a directory.</action> <if condition="path-not-found">Tell the user: "Directory not found: <path>." Then stop.<exit /></if>