
Reset
- 848 installs
- 1.3k repo stars
- Updated July 26, 2026
- neolabhq/context-engineering-kit
reset is a context-engineering-kit agent skill that archives an in-progress FPF reasoning session and clears active hypothesis work for developers who need a fresh reasoning cycle without losing history.
About
reset is a runtime skill from neolabhq/context-engineering-kit that restarts the FPF (First-Principles Framework) reasoning cycle. Its soft-reset path creates a dated session archive under .fpf/sessions/ recording hypotheses at L0 proposed, L1 verified, and L2 validated counts, reset reason, and ISO timestamps, then clears active hypothesis work. Developers reach for reset when an FPF session stalls, hypotheses conflict, or the user requests a clean slate while preserving auditable session history on disk. The archive file uses YAML frontmatter with id, action, created, and reason fields so later reviews can reconstruct state at abandonment. reset is intentionally narrow—archive, clear, restart—making it the operational counterpart to hypothesis-building skills in the same context-engineering-kit. Unlike deleting .fpf data, soft reset preserves completed or abandoned reasoning trails for postmortems. Agents invoke reset at user request or when cyclical FPF work needs a documented fresh start without losing institutional memory from prior sessions.
- Soft reset archives the current FPF session to .fpf/sessions/ with reason and timestamp metadata
- Optional move of active L0/L1/L2 markdown hypotheses into .fpf/archive/ for a clean slate
- Captures hypothesis counts by level and whether a decision was finalized at reset time
- Reports reset completion paths so the user knows what was preserved versus cleared
- Supports user-requested fresh starts without silently deleting prior reasoning artifacts
Reset by the numbers
- 848 all-time installs (skills.sh)
- +46 installs in the week ending Jul 28, 2026 (Skillselion tracking)
- Ranked #1,232 of 16,659 AI & Agent Building skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
npx skills add https://github.com/neolabhq/context-engineering-kit --skill resetAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 848 |
|---|---|
| repo stars | ★ 1.3k |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 26, 2026 |
| Repository | neolabhq/context-engineering-kit ↗ |
How do you reset an FPF reasoning session?
Archive an in-progress FPF reasoning session and clear active hypothesis work so the agent can start a fresh cycle without losing history.
Who is it for?
Developers using context-engineering-kit FPF workflows who need a documented fresh start without deleting prior hypothesis archives.
Skip if: Projects not using FPF or .fpf/ session folders that only need generic git branch cleanup.
When should I use this skill?
User requests reset of the FPF reasoning cycle, fresh hypothesis work, or archiving an abandoned FPF session.
What you get
Session archive markdown in .fpf/sessions/ and cleared active FPF hypothesis workspace
- FPF session archive file
- Cleared active hypothesis state
Files
Reset Cycle
Reset the FPF reasoning cycle to start fresh.
Action (Run-Time)
Option 1: Soft Reset (Archive Current Session)
Create a session archive and clear active work:
1. Create Session Archive
Create a file in .fpf/sessions/ to record the completed/abandoned session:
# In .fpf/sessions/session-2025-01-15-reset.md
---
id: session-2025-01-15-reset
action: reset
created: 2025-01-15T16:00:00Z
reason: user_requested
---
# Session Archive: 2025-01-15
**Reset Reason**: User requested fresh start
## State at Reset
### Hypotheses
- L0: 2 (proposed)
- L1: 1 (verified)
- L2: 0 (validated)
- Invalid: 1 (rejected)
### Files Archived
- .fpf/knowledge/L0/hypothesis-a.md
- .fpf/knowledge/L0/hypothesis-b.md
- .fpf/knowledge/L1/hypothesis-c.md
### Decision Status
No decision was finalized.
## Notes
Session ended without decision. Hypotheses preserved for potential future reference.2. Move Active Work to Archive (Optional)
If user wants to clear the knowledge directories:
mkdir -p .fpf/archive/session-2025-01-15
mv .fpf/knowledge/L0/*.md .fpf/archive/session-2025-01-15/ 2>/dev/null || true
mv .fpf/knowledge/L1/*.md .fpf/archive/session-2025-01-15/ 2>/dev/null || true
mv .fpf/knowledge/L2/*.md .fpf/archive/session-2025-01-15/ 2>/dev/null || true3. Report to User
## Reset Complete
Session archived to: .fpf/sessions/session-2025-01-15-reset.md
Current state:
- L0: 0 hypotheses
- L1: 0 hypotheses
- L2: 0 hypotheses
Ready for new reasoning cycle. Run `/fpf:propose-hypotheses` to start.Option 2: Hard Reset (Delete All)
WARNING: This permanently deletes all FPF data.
rm -rf .fpf/knowledge/L0/*.md
rm -rf .fpf/knowledge/L1/*.md
rm -rf .fpf/knowledge/L2/*.md
rm -rf .fpf/knowledge/invalid/*.md
rm -rf .fpf/evidence/*.md
rm -rf .fpf/decisions/*.mdOnly do this if explicitly requested by user.
Option 3: Decision Reset (Keep Knowledge)
If user wants to re-evaluate existing hypotheses:
1. Move L2 hypotheses back to L1 (re-audit) 2. Or move L1 hypotheses back to L0 (re-verify)
# Re-audit: L2 -> L1
mv .fpf/knowledge/L2/*.md .fpf/knowledge/L1/
# Re-verify: L1 -> L0
mv .fpf/knowledge/L1/*.md .fpf/knowledge/L0/Related skills
FAQ
Where does reset store archived FPF sessions?
reset creates a markdown archive under .fpf/sessions/, for example session-2025-01-15-reset.md, with YAML frontmatter for id, action, created time, and reason.
What is the difference between soft reset and losing history?
reset soft reset archives the current hypothesis state—including L0, L1, and L2 counts—then clears active work so developers retain history while starting a fresh FPF cycle.
Is Reset safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.