Skip to content

Spec mandates @ references in the Phase Files table; every template and example uses backticked paths #7

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
TGPSKI merged 1 commit into from
Aug 9, 2026
Merged

Spec mandates @ references in the Phase Files table; every template and example uses backticked paths #7

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ Every PR must:

### Running Validation

There is no build step. Review your markdown renders correctly and all internal `@`-references resolve to existing files.
There is no build step. Review your markdown renders correctly and all internal links resolve to existing files.

### License

Expand Down
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ ln -s ../../.agents/skills/onboard-chart .cursor/skills/onboard-chart
ln -s ../../.agents/skills/onboard-chart .claude/skills/onboard-chart
```

Invoke the workflow: `@onboard-chart/SKILL.md`. Come back next week, invoke the same file, and it picks up where you left off.
Invoke the workflow: `@onboard-chart/SKILL.md`. This is a prompt mention that attaches the router to the conversation -- distinct from how a router references its phase files, which is by backticked relative path. Come back next week, invoke the same file, and it picks up where you left off.

---

Expand Down
3 changes: 2 additions & 1 deletion SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -137,6 +137,7 @@ The router:
- Collects ONE key identifier (service name, account alias, hostname, etc.)
- Detects progress by inspecting the repo (which files exist = which phases done)
- Routes to the correct phase
- Names the phase file by relative path and instructs the agent to read it. The read is the load; a bare path is not a directive to load anything.
- **Never generates files itself**

The router MUST include:
Expand All @@ -145,7 +146,7 @@ The router MUST include:
3. **Progress Detection table** -- maps file existence to phase completion
4. **Determine Phase table** -- maps detected state to recommended action
5. **Route to Phase** -- presents options to the user
6. **Phase Files table** -- lists all phases with `@` references
6. **Phase Files table** -- lists all phases as backticked relative paths, one level deep from the router

### Phase Module Rules

Expand Down