vf-new

Create a new voice profile. Never overwrite an existing profile or file.

1. Name. The word after the command is the profile name. It must be lowercase words joined by hyphens, ending in -en or -es (for example youtube-es, philosophy-en). If it is missing or does not fit, suggest a valid name and ask.
2. The brief. Ask once, in one short message. The brief is the most important part of a profile: agents use it to pick the profile and to judge the writing against its field.
   • What is this voice for? (for example "journal articles in development economics")
   • Who reads or hears it?
   • Which field and venues? (journals, a channel, a blog)
   • Main topics?
   • The register, if it is not obvious (academic, conversational, spoken).
   • Which kinds of documents (papers, emails, posts), and what the profile should not be used for?
   • Is it fiction? Voice Forge's schema is for nonfiction; for fiction, add --type fiction below. Write down what the user says, in their words. Do not invent conventions.
3. Create it. Run, from this skill's folder: python3 ../voice-forge/scripts/vf.py init --profile <name> --purpose "<purpose>" --register "<register>" --audience "<readers>" If that path does not resolve, find scripts/vf.py in the installed voice-forge skill. If the profile already exists, the command changes nothing: tell the user and stop. If no voice home exists yet, run setup first (see ../voice-forge/references/setup.md).
4. Fill the brief. In the new profiles/<name>/rules.md, fill section 1 (Genre and document types, Field and venues, Topics, Scope) with the user's answers. Leave Conventions empty; Analyze mode and the user fill it later. Leave sections 2 to 10 as Status: unknown: training fills them. Run vf.py validate --profile <name>; it should show no errors.
5. Topics. Propose about 15 training topics that fit the brief, one per line as slug: short description, in the profile's language. Ask the user to approve, cut or add. Then write the approved list into the new topics.md, replacing the starter topics.
6. Save. Run python3 ../voice-forge/scripts/vf.py save -m "add profile <name>". It commits and pushes to the private repo if one is linked.
7. Next step. Tell the user the two ways to start: vf-analyze <name> with some past texts, or vf-train <name>.

Without a shell, create the files by hand following ../voice-forge/references/profile-format.md, and only if the profile folder does not exist yet.