@juancr11/sibu 0.12.3 → 0.12.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@juancr11/sibu",
3
- "version": "0.12.3",
3
+ "version": "0.12.4",
4
4
  "description": "CLI for setting up a local AI-augmented development workflow.",
5
5
  "repository": {
6
6
  "type": "git",
@@ -1,5 +1,5 @@
1
1
  {
2
- "templateVersion": "94",
2
+ "templateVersion": "95",
3
3
  "templates": {
4
4
  "AGENTS.md": {
5
5
  "version": "28",
@@ -58,10 +58,10 @@
58
58
  ]
59
59
  },
60
60
  "skills/deep-module-map-writer/SKILL.md": {
61
- "version": "3",
61
+ "version": "4",
62
62
  "description": "Mandatory Deep Module Map writer skill installed once at the shared .agents/skills workspace path.",
63
63
  "changes": [
64
- "Strengthens Deep Module Map interviews to ask as many one-at-a-time questions as needed and resolve material boundary questions before drafting."
64
+ "Adds explicit Deep Module Map discovery guidance so agents keep interviewing one question at a time until module interfaces, hidden complexity, ownership, exclusions, scenarios, relationships, and cross-module rules are clear enough to defend."
65
65
  ]
66
66
  },
67
67
  "skills/feature-brief-writer/SKILL.md": {
@@ -139,6 +139,42 @@ Be deliberately interrogative before writing.
139
139
  - If the conversation stalls, propose one concise assumption for the next unresolved point and ask the user to confirm or correct it.
140
140
  - Draft only when there are no material open questions about interfaces, hidden complexity, ownership, exclusions, relationships, or cross-module rules.
141
141
 
142
+ ## Clarify module intent before drafting
143
+
144
+ Do not draft a Deep Module Map from a vague product idea, feature label, command name, screen, folder, or implementation mechanism alone. The map must reflect the user's actual system responsibilities and the complexity boundaries that should stay stable over time.
145
+
146
+ A request is too vague when the user gives only a broad area such as "onboarding," "analytics," "sync," "workflow," "AI features," "the CLI," or "the database" without enough detail to know what capability the rest of the system should rely on or what implementation complexity should be hidden.
147
+
148
+ When module intent is vague or incomplete:
149
+
150
+ 1. Stop before drafting.
151
+ 2. Explain briefly that a responsible Deep Module Map requires more boundary context.
152
+ 3. Ask one focused discovery question.
153
+ 4. Wait for the user's answer.
154
+ 5. Continue asking one question at a time until there is enough context to defend the map.
155
+ 6. Draft only after the module candidates, interfaces, hidden complexity, ownership, exclusions, scenarios, relationships, and cross-module rules are clear enough to avoid invention.
156
+
157
+ Do not ask the user to answer a large questionnaire all at once. Keep the interview conversational and focused.
158
+
159
+ ## Gather the minimum required module context
160
+
161
+ Ask every question needed to remove material ambiguity, but only one at a time. Clarify:
162
+
163
+ - what product or system capabilities the map must support
164
+ - what the rest of the app should be able to ask each area to do
165
+ - what messy details callers should not need to know
166
+ - which decisions or policies should change together
167
+ - which responsibilities each candidate module owns
168
+ - which responsibilities each candidate module explicitly does not own
169
+ - key scenarios that prove the module boundary is useful
170
+ - relationships and dependencies between candidate modules
171
+ - cross-module rules such as user ownership, safety, validation, local customization, or read-only vs mutating behavior
172
+ - where future implementation work is likely to create boundary confusion
173
+
174
+ Treat "enough context" as: candidate modules, suggested slugs, simple external interfaces, hidden implementation complexity, responsibilities, exclusions, scenarios, relationships, and cross-module rules are all clear enough to defend. Do not draft a map with an `Open Questions` section. Resolve material questions during the interview, or record only known risks/tradeoffs after decisions are made.
175
+
176
+ If the conversation stalls, offer one concise default assumption for the next unresolved boundary and ask the user to confirm, correct, or reject it before proceeding.
177
+
142
178
  ## Interview method
143
179
 
144
180
  Derive candidate modules from answers. Do not make the user design the map from scratch.