Skip to content

Commit 0e9e7f9

Browse files
committed
feat: add interactive creation questionnaire to authoring.md
Add a structured 6-step sequential questionnaire for creating new bash scripts from scratch. Each question is asked individually, ensuring the agent collects all necessary context before generating the script.
1 parent b03979e commit 0e9e7f9

1 file changed

Lines changed: 34 additions & 1 deletion

File tree

  • skills/software-development/scripts-bash/references

skills/software-development/scripts-bash/references/authoring.md

Lines changed: 34 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,39 @@ bash -n path/to/script.sh
7474

7575
Agent: full script only; path+size in chat; bump Ver; leave Title Case comments alone unless asked.
7676

77+
## Interactive creation
78+
79+
Use this path only when the user asks to **create a brand-new script from scratch** (not a rewrite of an existing file).
80+
81+
**Ask exactly one question at a time.** Wait for the answer before asking the next. Never present a multi-question list.
82+
83+
**Q1. Script name** — exact filename, e.g. `installer-camofox.sh`
84+
85+
→ Wait for answer.
86+
87+
**Q2. Purpose** — one-line purpose statement that goes into the `Define:` header line
88+
89+
→ Wait for answer.
90+
91+
**Q3. Case routines?** — Do you want case routines (arguments)? Answer Yes or No.
92+
93+
→ Wait for answer.
94+
95+
- If **No**, skip to Q5.
96+
- If **Yes**, ask each routine on its own turn: "Routine name and one-line description:" — repeat for each.
97+
98+
**Q4. ROUTine list** — for each routine, ask separately: name + one-line description.
99+
100+
→ Wait after each.
101+
102+
**Q5. DEBUG value**`true` or `false`
103+
104+
→ Wait for answer.
105+
106+
**Q6. Extra constraints** — any extra paths, ports, or constraints? Reply "none" if nothing to add.
107+
108+
→ After the final answer, copy `templates/template-base.sh` to the product path, fill the header and case block, then write the complete script.
109+
77110
## What good output looks like
78111

79112
- Header Author/Date/Ver/Name/Define, columns aligned
@@ -100,4 +133,4 @@ Host-only product briefs may live under profile `workspace/prompts/` — not in
100133
1. Install lean skill under `~/.hermes/skills/software-development/scripts-bash/`
101134
2. `/skill scripts-bash`
102135
3. Copy `templates/template-base.sh` to a throwaway path; add `status` that prints OK
103-
4. `bash -n` and run `status`
136+
4. `bash -n` and run `status`

0 commit comments

Comments
 (0)