Skip to content

chore(dev): unify current context and project skills - #960

Merged
antropos17 merged 1 commit into
masterfrom
codex/context-skills-consistency-20261017
Oct 16, 2026
Merged

antropos17 merged 1 commit into
masterfrom
codex/context-skills-consistency-20261017

Conversation

@antropos17

@antropos17 antropos17 commented Oct 16, 2026 •

Copy link
Copy Markdown
Owner

Description

New sessions could follow an obsolete task at the top of next-session.md, while independently maintained Codex and Claude skills disagreed about source navigation and verification. Add one current-context entry point and a versioned project-skill catalog, then route shared workflow and coding rules to their owners.

  • Preserve the previous session handoff and complete design decisions verbatim in adjacent history files. Short entry points identify applicable amendments and keep historical tasks from becoming implicit instructions. Exclude those dated archives from live inventory-count declarations.
  • Consolidate contribution/branch guidance, repair the stale verification link and dependency inventories, and clarify read-only role instructions without changing model or permission configuration.
  • Publish the 14 project skills under tools/agent-skills/, retaining upstream licenses and explicit-only shipping controls. A dependency-free synchronizer previews by default, installs both ignored client copies explicitly, checks drift, and refuses customized, linked or retired installation files before writing. It targets its own checkout and preserves unrelated local files.

The history copies account for 1,973 added lines; their content is unchanged from the base. Application runtime, workflows, lockfiles and the primary checkout's existing changes are outside this package. Local skill copies were installed only in the isolated task worktree.

Type of change

  • Bug fix
  • New feature (development tooling)
  • Breaking change
  • Documentation update

Testing

  • Windows / Node 24.11.1: focused Vitest suite, 8/8 passing. Covers preview without writes, both clients and invocation metadata, repeat/update behavior, unknown/customized-file preservation, junction/symlink refusal, path traversal refusal and retired-file preservation.
  • All 14 skills passed skill-creator frontmatter validation; role TOML and YAML metadata parsed successfully.
  • Explicit installation followed by --check: 40 files aligned, zero drift. The preview and fixture tests do not modify the primary checkout.
  • Structural scan of 255 Markdown files: no missing local targets or heading candidates. Both history copies match the base after line-ending normalization. This is a link/structure check, not a claim that every historical statement is current.
  • Focused ESLint and Prettier checks, git diff --check, and counts:check: passing; 69/69 live declarations agree.
  • Primary checkout dirty-file SHA-256 values and status match the pre-task snapshot.

Dependencies were installed in the isolated worktree with npm ci --ignore-scripts; no native helpers or Electron runtime were launched locally. All five required hosted CI contexts (build, lint, svelte-check, test, audit) passed for head bb257e5f6ef3cc618930138fdc7c23cf197eb5ce: CI run. Agent routing cases were reviewed statically; no independent agent evaluation or human review is claimed.

Checklist

  • Follows code style guidelines (CommonJS main, Svelte 5 renderer)
  • No console.log in production code
  • New files stay focused and follow the applicable AGENTS.md conventions
  • I ran the applicable local checks and recorded their results above
  • This code has been reviewed by a human (not solely AI-generated)

@antropos17
antropos17 merged commit 9ec8bf2 into master Oct 16, 2026
5 checks passed
@antropos17
antropos17 deleted the codex/context-skills-consistency-20261017 branch October 16, 2026 21:13
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.

1 participant