@contextium/cli 1.0.10 → 1.0.12

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": "@contextium/cli",
3
- "version": "1.0.10",
3
+ "version": "1.0.12",
4
4
  "description": "Command-line tool for managing Contextium documentation, agents, skills, and workflows — pipe context to AI coding assistants",
5
5
  "keywords": [
6
6
  "contextium",
@@ -105,13 +105,11 @@ Based on the project description and the analysis, build a setup plan. Think thr
105
105
 
106
106
  **Libraries:** What distinct knowledge areas did the user mention? Each major topic or type of content that needs to be stored separately should be its own library. If an existing library already covers one of these, mark it for reuse.
107
107
 
108
- **Agents:** What kind of AI assistant roles would serve this project? Think about what tasks the user will perform research, writing, analysis, Q&A, etc. If an existing agent fits, mark it for reuse.
108
+ **Agents:** Always include a "Project Architect" agent as the first agent — its role is to define the project process, break the work into phases, and track overall progress. Write its system prompt to be specific to this project's domain and goals. Then think about what other AI assistant roles would serve this project based on what the user described. If an existing agent fits one of the additional roles, mark it for reuse.
109
109
 
110
110
  **Skills:** What reusable knowledge blocks would help agents working on this project? Think about domain-specific guidelines, reference material, or persistent context the agent needs. If an existing skill fits, mark it for reuse.
111
111
 
112
- **Tags:** What topic or category labels would make sense for organising content in this project? Look for existing tag types that match. If none exist, suggest new ones. Think in terms of tag categories (e.g. `topic`, `source`, `status`) and the specific tag values within them (e.g. `topic:space-travel`, `topic:rocket-engineering`).
113
-
114
- **Workflow:** Propose one workflow name that bundles everything together for quick loading.
112
+ **Tags:** What topic or category labels would make sense for organising **files within context libraries** for this project? Tags apply to library files only — never suggest tags for agents or skills. Look for existing tag types that match. If none exist, suggest new ones. Think in terms of tag categories (e.g. `topic`, `source`, `status`) and the specific tag values within them (e.g. `topic:space-travel`, `topic:rocket-engineering`).
115
113
 
116
114
  Present the plan in this format (omit any section that has nothing in it):
117
115
 
@@ -119,29 +117,32 @@ Present the plan in this format (omit any section that has nothing in it):
119
117
 
120
118
  Here's what I'll set up for you:
121
119
 
122
- **New libraries to create**
123
- - "Library Name" — reason why this is needed
120
+ **Libraries**
124
121
 
125
- **Existing libraries to reuse**
126
- - "Library Name" — why it's relevant
122
+ | Action | Name | Purpose |
123
+ |--------|------|---------|
124
+ | Create | "Library Name" | reason why this is needed |
125
+ | Reuse | "Library Name" | why it's relevant |
127
126
 
128
- **New agents to create**
129
- - "Agent Name" — what it will do for this project
127
+ **Agents**
130
128
 
131
- **Existing agents to reuse**
132
- - "Agent Name" — why it fits
129
+ | Action | Name | Purpose |
130
+ |--------|------|---------|
131
+ | Create | "Agent Name" | what it will do for this project |
132
+ | Reuse | "Agent Name" | why it fits |
133
133
 
134
- **New skills to create**
135
- - "Skill Name" — what knowledge it will hold
134
+ **Skills**
136
135
 
137
- **Existing skills to reuse**
138
- - "Skill Name" — why it fits
136
+ | Action | Name | Purpose |
137
+ |--------|------|---------|
138
+ | Create | "Skill Name" | what knowledge it will hold |
139
+ | Reuse | "Skill Name" | why it fits |
139
140
 
140
- **Tags to create**
141
- - `category:value` — why this label is useful
141
+ **Tags**
142
142
 
143
- **Workflow**
144
- - "Workflow Name" — bundles everything above for quick loading
143
+ | Tag | Purpose |
144
+ |-----|---------|
145
+ | `category:value` | why this label is useful |
145
146
 
146
147
  Shall I go ahead and create all of this?
147
148
 
@@ -151,7 +152,9 @@ Wait for the user to confirm, adjust, or say skip on any item before proceeding.
151
152
  </step>
152
153
 
153
154
  <step name="create_resources">
154
- Only create what the user confirmed. Create in this order: tag types → tags → libraries → skills → agents → workflow.
155
+ Only create what the user confirmed. Create in this order: tag types → tags → libraries → skills → agents.
156
+
157
+ Do NOT create a workflow in this step.
155
158
 
156
159
  Show `✓ Created "Name"` for each item as it is created. Show `↗ Reusing "Name"` for each existing resource being included.
157
160
 
@@ -170,13 +173,26 @@ contextium tag-type create "<name>" --workspace <slug>
170
173
  **MCP:** use the corresponding create_* tools for each resource type.
171
174
  </step>
172
175
 
173
- <step name="load_workflow">
174
- After all resources are created, automatically load the workflow without asking the user. Run silently:
176
+ <step name="workflow_prompt">
177
+ After all other resources are created, ask the user:
178
+
179
+ "Would you like me to create a workflow to bundle everything together for quick loading? If yes, what would you like to call it?"
180
+
181
+ Use AskUserQuestion with two options:
182
+ - "Yes, create a workflow" (and ask for the name as a follow-up if they say yes)
183
+ - "No, skip workflow"
184
+
185
+ If they say yes and provide a name, create the workflow:
186
+
187
+ **CLI:** `contextium workflow create "<name>" --workspace <slug>`
188
+ **MCP:** call mcp__contextium__create_workflow with the name and workspace.
189
+
190
+ Then automatically load it:
175
191
 
176
- **CLI:** `contextium workflow load "<workflow-name>" --workspace <slug> 2>/dev/null`
192
+ **CLI:** `contextium workflow load "<name>" --workspace <slug> 2>/dev/null`
177
193
  **MCP:** call mcp__contextium__load_workflow with the workflow name and workspace.
178
194
 
179
- Do not tell the user to load it themselves — just load it as part of setup.
195
+ If they say no, skip workflow creation and loading entirely.
180
196
  </step>
181
197
 
182
198
  <step name="summary">
@@ -190,7 +206,7 @@ Libraries: <list — new + reused>
190
206
  Agents: <list — new + reused, or none>
191
207
  Skills: <list — new + reused, or none>
192
208
  Tags: <list, or none>
193
- Workflow: <name> — loaded and ready
209
+ Workflow: <name> — loaded and ready (or "none" if skipped)
194
210
  ```
195
211
 
196
212
  If anything failed to create, add a single line at the end:
@@ -205,6 +221,7 @@ If anything failed to create, add a single line at the end:
205
221
  - Run all checks and fetches silently — only surface progress labels and the final plan
206
222
  - Only ask questions when genuinely needed — the description step and the confirmation step
207
223
  - Do not ask the user what to create — figure it out from the description, then ask them to confirm
224
+ - Always create a "Project Architect" agent first, regardless of what the user described — tailor its system prompt to the specific project domain and goals
208
225
  - If a resource already exists and is relevant, always prefer reuse over creating a duplicate
209
226
  - The plan report must explain the reasoning for each item — not just list names
210
227
  - Never create anything before the user confirms the plan