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

Advanced and Deep effort levels lack 'When' criteria

Open Beginner friendly
#6 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
72/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Stale
Domain
documentation

Research direction

Open versions/TheAlgorithm_Latest.md around lines 40-41 and review the effort-level table, especially Advanced and Deep. Add distinct When criteria consistent with the issue's suggested scope; done means both tiers have non-overlapping guidance and the table remains correctly formatted.

Written by the indexing model from the issue text.

Description

The Issue

The effort level table in OBSERVE defines 8 tiers, but Advanced and Deep have no guidance on when to use them:

Tier Budget When
Instant <10s "right now", trivial lookup, greeting
Fast <1min "quickly", simple fix, skill invocation
Standard <2min Normal request, no time pressure stated
Extended <8min Still needed relatively fast, but quality must be extraordinary
Advanced <16min (no "When" criteria — description same as Deep)
Deep <32min (no "When" criteria — description same as Advanced)
Comprehensive <120m Don't feel rushed by time
Loop Unbounded External loop, PRD iteration

Both Advanced and Deep have identical descriptions: "Full phases, checkpoints every 1 min" — making it impossible to distinguish when one should be selected over the other.

Suggested Fix

Add "When" guidance. For example:

  • Advanced: "Multi-system changes, cross-cutting concerns, significant refactors"
  • Deep: "Architectural decisions, novel problem domains, research-heavy work"
Location
  • Lines ~40-41 in versions/TheAlgorithm_Latest.md
Dominant language
No language data
Stars
158
Forks
18
PR merge metrics
No merged PRs in 30d

Contributor guide

No contributing guide indexed for this repository

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/TheAlgorithm

All issues in danielmiessler/TheAlgorithm

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.