Skip to content

Latest commit

 

History

History
101 lines (58 loc) · 2.14 KB

File metadata and controls

101 lines (58 loc) · 2.14 KB

Hum RFC Template

Status: sketch | experimental | candidate | stable | rejected Date: YYYY-MM-DD Author: BDFL decision:

Problem

What real programmer, compiler, agent, safety, performance, or pedagogy problem does this solve?

Proposal

Describe the change in one page or less.

Examples

Show Hum before and after.

// before
// after

Beginner Explanation

How would this be taught to someone who knows English but not programming?

Senior Engineer Explanation

What does this make explicit that senior engineers already reason about?

Semantic Graph Impact

What nodes, edges, fields, or diagnostics are added?

Diagnostics

What error messages or warnings does this need?

Toolchain Impact

How does this affect syntax highlighting, Tree-sitter, LSP, debugger stepping, source maps, profiler output, and agent semantic graph consumption?

Formatter Behavior

How should canonical Hum format this feature?

Safety And Security

What can go wrong? What does this hide or reveal?

Cross-Language Regret Check

Which old language regret does this avoid? Which old language regret could it recreate? What tool catches misuse before it becomes culture?

Ergonomics And Operator Surface

If this adds syntax, an operator, or a convenience path, what repetition does it remove, what meaning might it hide, and how do humfmt, chirp, and the semantic graph keep it honest?

Performance And Allocation

What does this cost? Can it support cost:, benchmarks:, or static checks?

Optimization And DSA Evidence

If this touches algorithms, data structures, memory layout, compile-time optimization, or standard-library behavior, what research, benchmark, fallback, and adversarial evidence supports it?

Tests, Proofs, And Benchmarks

What evidence must exist before this can stabilize?

Agent Impact

How will agents understand, edit, repair, and explain this feature?

Compatibility And Migration

Does this break anything? How does code migrate?

Alternatives Rejected

List serious alternatives and why they lost.

Open Questions

What remains uncertain?

BDFL Note

Final taste and direction note.