Upload folder using huggingface_hub

README.md

@@ -55,6 +55,13 @@ Tasks are categorized by the **depth of reasoning** required.
 | Medium | 15 | 6 | 2 | Relational: cross-file reasoning |
 | Hard | 25 | 10 | 3 | Sequential: cascading failures |
 
+**Notes** : 
+
+- Faults are typed (e.g., package_present, dockerfile_base, env_var_present, config_value, ci_stage_order, port_value).
+
+- Only the first failing stage is exposed per run; later faults are revealed after fixes.
+
+- Validation is structural, not string-based.
 
 See [docs/advanced_readme.md](advanced_readme.md) for the full variant breakdown, pipeline shapes, and reasoning about why hard is genuinely hard.