@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
package/templates/manifest.json
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
{
|
|
2
|
-
"templateVersion": "
|
|
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": "
|
|
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
|
-
"
|
|
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.
|