Skip to content

Commit 997fc50

Browse files
committed
Adding DECISIONS.md
1 parent f87ecfe commit 997fc50

1 file changed

Lines changed: 36 additions & 0 deletions

File tree

‎DECISIONS.md‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# DecRAS — Decision Log
2+
3+
> Append-only log of architectural decisions made in claude.ai conversations.
4+
> Claude Code reads this file for context. Do not edit manually except to append.
5+
6+
---
7+
8+
## 2026-03-29 — IK Bypass: Joint-Space Lookup Table
9+
10+
**Decision**: Replace placo/PyBullet IK with data-driven joint-space lookup table built from teleoperation recordings.
11+
12+
**Reason**: placo IK uses DH parameters that don't match the actual 3D-printed SO-101 arm geometry. The arm moves to wrong positions. This is fundamental — no amount of tuning fixes incorrect DH parameters on a 3D-printed arm.
13+
14+
**Approach**: Teleoperate arm to ~75 positions across workspace, record (Cartesian_position, joint_angles) pairs, use KDTree + inverse-distance interpolation for arbitrary targets. All trajectory generation in joint space via minimum-jerk profiles.
15+
16+
**Impact**:
17+
- New Phase 5.5 inserted before Phase 6 (BACKLOG.md)
18+
- Phase 6 (imitation learning) blocked until motion control is reliable
19+
- New Decision #6 added to ARCHITECTURE.md
20+
- Files to build: calibration/record_grid.py, control/joint_lookup.py, control/trajectory.py, control/executor.py
21+
22+
---
23+
24+
## 2026-03-29 — Project Workflow Established
25+
26+
**Decision**: Three-doc system (ARCHITECTURE.md + BACKLOG.md + DECISIONS.md) with automated sync.
27+
28+
**Reason**: Architectural decisions made in claude.ai conversations were not flowing into the repo. Claude Code had no visibility into strategic direction discussed here.
29+
30+
**Workflow**:
31+
- End of each claude.ai conversation → Claude produces a sync block → user appends to DECISIONS.md
32+
- Claude Code reads DECISIONS.md before every task (per CLAUDE.md rules)
33+
- Every PR updates BACKLOG.md (check off task) + PROJECT_STATUS.md (new capabilities)
34+
- Daily pulse via scripts/daily_pulse.py (GitHub Actions when billing unlocked)
35+
36+
---

0 commit comments

Comments
 (0)