Skip to content

Conversation

@thenewnickyzz
Copy link
Collaborator

Introduce infrastructure for bundling Claude Code skills and hooks
during init and upgrade workflows:

  • Add settings-merge utility for additive merging of Claude settings
  • Add buildforce-context-extract skill for automatic context extraction
  • Add hooks config template with Stop hook triggering context extraction
  • Update init/upgrade to merge Claude settings and manage skills
  • Update release packaging to bundle skills into Claude packages

How to test

Build something with claude code. At the end you should see the buildforce-context-extract working.

Introduce infrastructure for bundling Claude Code skills and hooks
@vidimitrov vidimitrov linked an issue Feb 5, 2026 that may be closed by this pull request
25 tasks
Copy link
Contributor

@vidimitrov vidimitrov left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall looks great 💪 I am starting to test it locally now, and will add some final feedback once ready

Disregard changes that match ANY of:
- Root-level `*.md` files (README, CHANGELOG, etc.)
- Lock files
- Files under `.buildforce/`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This might be a little hard filter until we introduce the new plan/build approach


Derive a semantic module name from each directory:
- `src/auth/*` → "authentication"
- `src/templates/commands/*` → "slash-commands"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here might be good to explciitly highlight that these are examples. Agents could easily hallucinate on this instructions


## Step 3: Spawn Extractor Sub-Agents

Use the Task tool to spawn all three extractors in parallel.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Have you experienced use cases where it doesn't spawn the sub-agents at all? I am highly skeptical how the skill will spawn the correct sub-agents without explicit instruction. But what is more concerning is that we don't create the _extraction-progress.yaml for each sub-agent and they already expect to read it.

If partial failure:
```
⚠️ Context partially updated: {success_count} file(s), {error_count} extractor(s) failed
• Run /buildforce.extract to retry
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we really do that (running a slash command from a skill)? Have you managed to run this failure mode?

"hooks": [
{
"type": "agent",
"prompt": "Call the buildforce-context-extract skill",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should definitely add a lot more "CRITICAL", "IMPORTANT", etc. guardrails inside the skill, so it doesn't trigger unless really needed. Otherwise, users will be very annoyed 😅

| deep | Full rationale | Expert |

Context: {$ARGUMENTS}
Call the buildforce-context-extract skill with these arguments: $ARGUMENTS
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't need the slash command anymore, as the skill is user-invocable. Let's remove this one and rename the skill accordingly


---

## Step 1: Cold Start Mode
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Potentially we can break each mode into a separate file. Skills are already recommending that.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Context Contribution skill

2 participants