Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

ISA Scaffold can write a task-grade ISA over a project's `ISA.md`

Open Beginner friendly
  • Is something wrong?
#2,335 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 11 days

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
88/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
git, markdown
Domain
developer-experience, documentation

Research direction

Start with skills/ISA/Workflows/Scaffold.md and skills/ISA/SKILL.md, following the path rules and existing ISA examples. Update the task-grade versus substantial-grade routing, archive guidance, and Git checks; validate that root ISA.md is tracked and not ignored with the commands in the issue.

Written by the indexing model from the issue text.

Description

Problem. skills/ISA/Workflows/Scaffold.md:24 routes to <project-root>/ISA.md whenever a project is passed. Nothing stops a single-ticket, task-grade ISA from landing on, or being appended to, the project's long-lived system-of-record file. Nothing checks that the file is tracked either. A .gitignore entry can hide it from the repo.

Proposed change.

  1. In Scaffold.md, add a home rule: <project-root>/ISA.md is written only at substantial grade with a project-scoped Goal. A task-grade ISA goes to MEMORY/WORK/{slug}/ISA.md, and its claims are folded into the project ISA as a feature block.
  2. Add a gotcha to SKILL.md: an existing task-shaped root ISA is archived with git mv under docs/isa-archive/, not extended.
  3. After writing a root ISA, confirm git ls-files --error-unmatch ISA.md exits 0 and git check-ignore ISA.md exits 1.

Pseudo-diff.

 ## Procedure (Scaffold.md, after the path list)
+**Home rule.** `<project-root>/ISA.md` is substantial-grade, project-scoped only. Task-grade → MEMORY/WORK/{slug}/ISA.md.
+An existing task-grade root ISA is archived (git mv docs/isa-archive/<date>-task-isas.md), never extended.
+A .gitignore rule matching root ISA.md is a defect to remove.
 ## Output
+When the path is <project-root>/ISA.md, confirm it is tracked and not ignored.

Why canon benefits. The project's system of record is protected from being silently overwritten or orphaned by per-ticket work.

Dominant language
TypeScript
Stars
19.4k
Forks
2.5k
No merged PRs in 30d

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from danielmiessler/LifeOS

All issues in danielmiessler/LifeOS

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.