Write

/write — Context Externalizer

Move knowledge from the context window into a structured, persistent file in .wisci/context/. This is the "save to disk" operation — preserve what would otherwise be lost to context limits or session endings.

Boundary: /write stores reusable knowledge (research, decisions, architecture notes). Session work state (goal, in-progress, next steps) belongs in /compress.

Timestamp: !date '+%Y-%m-%d %H:%M'

Execution Flow

1. Parse arguments. Read $ARGUMENTS to determine what to externalize from the current context.

1. Derive topic slug. Extract the core topic noun phrase (strip filler: "results on", "notes about"), kebab-case, lowercase, max 5 words. If the user names a target file explicitly, use it.

1. Check for existing file. Glob .wisci/context/ for the slug:

• No match: Create Mode below.
• Exact match, same topic: Merge Mode — read and follow [references/merge-procedure.md](references/merge-procedure.md).
• Exact match, different topic: ask the user — merge or disambiguated new name.

1. Write to .wisci/context/.md (create directories as needed).

1. Confirm. Report path, created vs merged, and a one-line content summary.

Create Mode

1. Extract and structure the information from the current context per $ARGUMENTS
2. Organize into logical ## sections
3. Build a ## References section listing every file path mentioned in the content
4. Write using the output format below

Output Format

# 

> Last updated by /write on 
> Source: 

## Summary

## 

## Key Details
- **Decisions**: 
- **Open questions**: 

## References
- `src/auth/middleware.ts` — auth middleware, token validation logic
- `src/auth/session.ts:42` — session expiry configuration

Preservation Rules

Never summarize away:

• Exact file paths and line numbers
• Error messages and error codes
• Numeric values, measurements, benchmarks
• Command outputs and their results
• Decisions and the reasoning behind them
• Function, class, variable, and module names
• URLs and references

When condensing verbose material, compression must be reversible: keep the pointer (file path, URL, commit hash) next to every condensed claim so the detail is one Read away.

Key Constraints

• ## References is always the last section, each entry annotated with why it is referenced. This manifest powers staleness detection by /select and the bundled script ([scripts/wisci.py](scripts/wisci.py)).
• The ## References section is rebuilt from scratch on every write — current state, not accumulated history.
• When in doubt during merge, preserve both versions and flag with ``.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ph3on1x
• Source: ph3on1x/wisci
• License: MIT

Install and usage instructions live in the source repository linked above.