docs: expand README and HF metadata

README.md

@@ -1,3 +1,45 @@
 ---
 license: apache-2.0
+tags:
+	- peft
+	- lora
+	- dora
+	- text-classification
+	- intent-classification
+library_name: peft
 ---
+
+# intent-classifier-experiments
+
+This Hugging Face repo stores all experiment-time adapter artifacts for the
+intent-classifier project.
+
+## Purpose
+
+- Keep every adapter checkpoint produced during tuning.
+- Preserve per-experiment traceability across versions.
+- Keep release artifacts separate from experimental artifacts.
+
+## Layout
+
+- v1.0/
+	- one folder per experiment run
+	- naming format:
+		- {model}_{technique}_{config}_{dataset_size}_{YYYYMMDD-HHMMSS}
+
+Each experiment folder can include:
+- adapter weights,
+- tokenizer/config files,
+- metadata and training outputs.
+
+## Related repositories
+
+- Training code: https://github.com/kon172verma/intent-classifier
+- Final release models: https://huggingface.co/kon172verma/intent-classifier
+- Inference/benchmarking: https://github.com/kon172verma/intent-classifier-inference
+
+## Versioning
+
+Experiment folders are grouped by release version (for example, v1.0).
+When a version is finalized, only selected best models are promoted to the
+release repo.