tpp

AI Community

Skill notes

Required Reading First

Before any work, read these documents: CLAUDE.md docs/SIMPLE-DESIGN.md docs/TDD.md docs/TPP-GUIDE.md

Process

Read the TPP from the path given (default: check _todo/ for existing TPPs) Read all documents listed in the TPP's "Required reading" section Identify the current phase from the checklist Execute work matching that phase: Research & Planning: Explore code, read docs, summarize findings in TPP

Project Conventions

Always run npm run compile before testing Use ?? (not ||) for nullish coalescing Use node: prefix for Node.js imports Use if (x != null) not if (x) for boolean safety No mocks in tests - use real ExifTool and actual image files

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
AI
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
94 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@photostructure · MIT
Token usage
Lean
Setup complexity
Guided setup
External API key
Not required
Operating systems
macOS · Linux · Windows
Runtime requirements
Node.js
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Author source file SKILL.md

# Work on TPP

Make progress on the referenced Technical Project Plan by determining the current
phase and taking appropriate action.

## Required Reading First

Before any work, read these documents:

- [CLAUDE.md](CLAUDE.md)
- [docs/SIMPLE-DESIGN.md](docs/SIMPLE-DESIGN.md)
- [docs/TDD.md](docs/TDD.md)
- [docs/TPP-GUIDE.md](docs/TPP-GUIDE.md)

## Process

1. Read the TPP from the path given (default: check `_todo/` for existing TPPs)
2. Read all documents listed in the TPP's "Required reading" section
3. Identify the current phase from the checklist
4. Execute work matching that phase:
   - **Research & Planning**: Explore code, read docs, summarize findings in TPP
   - **Write breaking tests**: Write tests that fail, proving the problem exists
   - **Design alternatives**: Propose options with pros/cons in the Solutions section
   - **Task breakdown**: Create specific, verifiable tasks with file paths and commands
   - **Implementation**: Write code, compile (`npm run compile`), run tests (`npm test`)
   - **Review & Refinement**: Lint (`npm run lint`), simplify, DRY up, remove dead code
   - **Final Integration**: Verify all tests pass, update docs if needed
   - **Review**: Final check against SIMPLE-DESIGN.md principles
5. Update the TPP with progress, findings, and any new lore
6. When done, move the TPP from `_todo/` to `_done/`

## Project Conventions

- Always run `npm run compile` before testing
- Use `??` (not `||`) for nullish coalescing
- Use `node:` prefix for Node.js imports
- Use `if (x != null)` not `if (x)` for boolean safety
- No mocks in tests - use real ExifTool and actual image files
- Conventional Commits for commit messages
- Always ask before committing or pushing

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.