mcpField
D
ds-context-reset

ds-context-reset

github.com/aicodekingAgent workflows263452 installsUpdated 2w ago
Repository

About ds-context-reset

ds-context-reset is a workflow skill for recording task state in a repository so work can resume in a fresh context. It is intended for long coding tasks and centers on a concise, evidence-based PROGRESS.md handoff.

Key features

  1. 01Structured PROGRESS.md handoffs
  2. 02Record verified steps and evidence
  3. 03Detect context-reset signals
  4. 04Fresh-session continuation guidance
  5. 05Three-reset stop condition

Use cases

  1. 01Resume a long repository task in a new session
  2. 02Track verified work and remaining steps
  3. 03Stop and report after repeated stalled attempts

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/aicodeking/deepseek-stack --skill ds-context-reset

After installing, type/ds-context-resetin Claude Code to confirm it loaded.

Details

From the project README

ds-context-reset

Store the state of the work in a file, not in the chat, so a fresh context can continue without drift.

Steps

  1. At the start of a long task, create PROGRESS.md at the repo root with these sections:
    • Goal: one or two sentences, plus the acceptance check for the whole task.
    • Done: the verified steps, each with the command and result that proved it.
    • Next: the ordered steps that remain. The first item is the exact next action.
    • Open questions: unknowns and decisions that wait for the user.
    • Key facts: paths, commands, versions, gotchas, and approaches that failed (with the reason).
  2. Update PROGRESS.md after every verified step. Do not update it for unverified ones. Commit the code and PROGRESS.md together with a descriptive message.
  3. Watch for reset signals: you repeat an earlier answer, you forget a fact that is in Key facts, you retry a fix that failed, the same file gets reread many times, or the context is more than about half full.
  4. When a signal appears, finish or revert the current step so the tree is in a known state.
  5. Rewrite PROGRESS.md as a complete handoff. A reader who has only this file and the repo must be able to continue. Remove chatter and keep the facts.
  6. Start a fresh session or subagent. Give it one instruction: "Read PROGRESS.md and git log -5, run the acceptance check for the last Done item, then do the first item in Next."
  7. In the new context, confirm that the baseline check passes before you make new edits. If it fails, fix that first.

Stop when

  • The goal's acceptance check passes and PROGRESS.md shows every item as Done.
  • You have done 3 resets on one Next item without progress. Stop and ask the user, with the file as your report.

Rules

  • PROGRESS.md holds facts and evidence, not plans that nobody has checked.
  • Keep it under about 150 lines. Move old Done items into a short summary line.
  • Never put secrets or tokens in it.
  • The fresh context reads the file, not the old transcript.
  • Pair with ds-plan-loop for the Next list and with ds-unstick for the failed-approach notes.

Comments

Markdown supported