Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 37 additions & 0 deletions .codex/plans/2026-04-09-skill-progressive-disclosure.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# Skill Progressive Disclosure

## Summary

- Split skills into metadata-first objects and explicit content reads.
- Keep prompt injection lightweight: only skill catalog metadata goes into agent context.
- Align backend, CLI, and web on the same explicit content-loading flow.

## Key Changes

- `internal/skills`
- Remove eager `Content` retention from `skills.Skill`.
- Keep load-time parsing/scanning of `SKILL.md`, but discard the body after verification.
- Add lazy content loading for resolved skills, including filesystem and bundled skills.
- `internal/api`
- Make `GET /api/skills` and `GET /api/skills/:name` metadata-only.
- Add `GET /api/skills/:name/content` in HTTP and UDS.
- Remove `content` from the main skill payload contract.
- `internal/cli`
- Keep `agh skill view` as the explicit full-content reader, backed by lazy loading instead of preloaded `skill.Content`.
- `web`
- Keep metadata/detail fetches lightweight.
- Load full skill content only when the user clicks `View full content`.
- Show loading/error/success states in the content card.

## Tests

- Verify registry load paths do not retain skill bodies.
- Verify lazy content reads for bundled and filesystem skills.
- Verify list/detail handlers are metadata-only and the new content endpoint returns the body.
- Verify CLI `skill view` still renders full content and resources.
- Verify web adapters/hooks/components only fetch content on explicit click.

## Assumptions

- Breaking `content` out of the generic skill payload is acceptable in this greenfield codebase.
- The new explicit-read endpoint covers only the main `SKILL.md` body; resource-file reads stay on the CLI path for now.
313 changes: 313 additions & 0 deletions .compozy/tasks/extensability/analysis.md

Large diffs are not rendered by default.

238 changes: 238 additions & 0 deletions .compozy/tasks/extensability/analysis/analysis_claude_code.md

Large diffs are not rendered by default.

323 changes: 323 additions & 0 deletions .compozy/tasks/extensability/analysis/analysis_cross_cutting.md

Large diffs are not rendered by default.

343 changes: 343 additions & 0 deletions .compozy/tasks/extensability/analysis/analysis_goclaw.md

Large diffs are not rendered by default.

183 changes: 183 additions & 0 deletions .compozy/tasks/extensability/analysis/analysis_hermes.md

Large diffs are not rendered by default.

228 changes: 228 additions & 0 deletions .compozy/tasks/extensability/analysis/analysis_openclaw.md

Large diffs are not rendered by default.

285 changes: 285 additions & 0 deletions .compozy/tasks/extensability/analysis/analysis_openfang.md

Large diffs are not rendered by default.

230 changes: 230 additions & 0 deletions .compozy/tasks/extensability/analysis/analysis_pi_mono.md

Large diffs are not rendered by default.

Large diffs are not rendered by default.

9 changes: 9 additions & 0 deletions .compozy/tasks/web-ui-redesign/_meta.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
created_at: 2026-04-09T05:04:36.506547Z
updated_at: 2026-04-09T11:28:57.651031Z
---

## Summary
- Total: 8
- Completed: 8
- Pending: 0
14 changes: 14 additions & 0 deletions .compozy/tasks/web-ui-redesign/_tasks.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# Web UI Redesign — Task List

## Tasks

| # | Title | Status | Complexity | Dependencies |
|---|-------|--------|------------|--------------|
| 01 | Replace design tokens and fonts | done | high | — |
| 02 | Build custom sidebar with workspace icon rail | done | high | task_01 |
| 03 | Restyle session chat view | done | medium | task_01, task_02 |
| 04 | Add Skills HTTP endpoints | done | medium | — |
| 05 | Build skill frontend system | done | medium | task_04 |
| 06 | Build Skills page | done | high | task_02, task_05 |
| 07 | Build knowledge frontend system | done | medium | — |
| 08 | Build Knowledge page | done | high | task_02, task_07 |
Loading