norrisaftcc / norrisaftcc/algorithm-liza
M2: File tools — read_file, write_file, list_dir
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 0
- Forks
- 0
- Avg merge
- 1m
- Merged PRs (30d)
- 1
Description
Three of the four v0 tools from ADR-0002. All paths resolve inside the working directory and escape attempts are refused with a message the model can act on, not an exception.
Read-before-edit is worth adopting from little-coder: requiring a file to have been read before it can be written catches the common small-model failure of confidently rewriting a file it has only guessed the contents of.
Tool descriptions are system prompt tokens and the budget is tight. Write them terse and count them.
Done when all three tools are exercised end to end by a local model and covered by replay tests.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with ADR-0002 and compare the read-before-edit behavior with little-coder. Define the three tools around working-directory path confinement, actionable escape refusals, terse descriptions, and the read-before-write rule. Exercise them end to end with a local model and add replay tests covering the completed behavior.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- tooling
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100